Tutorials References Menu

Pandas DataFrame replace() Method

❮ DataFrame Reference


Example

Replace the value 50 with the value 60, for the entire DataFrame:

import pandas as pd

data = {
  "name": ["Bill", "Bob", "Betty"],
  "age": [50, 50, 30],
  "qualified": [True, False, False]
}
df = pd.DataFrame(data)

newdf = df.replace(50, 60)
Try it Yourself »

Definition and Usage

The replace() method replaces the specified value with another specified value.

The replace() method searches the entire DataFrame and replaces every case of the specified value.


Syntax

dataframe.replace(to_replace, value, inplace, limit, regex, method)

Parameters

The inplace, limit, regex, method parameters are keyword arguments.

Parameter Value Description
to_replace   Required, a String, List, Dictionary, Series, Number, or a Regular Expression describing what to search for
value   Optional, A String, Number, Dictionary, List or Regular Expression that specifies a value to replace with.
inplace True
False
Optional, default False. If True: the replacing is done on the current DataFrame. If False: returns a copy where the replacing is done.
limit Number
None
Optional, default None. Specifies the max limit of the size gap to fill 
regex True
False
None
Optional, default False. Specifies whether to replace using a regular expression or not.
method 'bfill'
'ffill'
'pad'
None
Optional, Specifies the how to replace if the value parameter is not present.

Return Value

A DataFrame with the result, or None if the inplace parameter is set to True.


❮ DataFrame Reference