PythonBeginner.help

How to Remove a Key from a Dictionary in Python

If you want to remove a key from a Python dictionary, the main tools are del and pop().

This page shows you:

  • How to remove one key from a dictionary
  • When to use del and when to use pop()
  • How to avoid KeyError if the key may not exist
  • What happens to the removed value

If you are new to dictionaries, see Python dictionaries explained.

Quick answer #

person = {"name": "Ana", "age": 25, "city": "Lima"}

# Remove a key and get its value
removed_value = person.pop("age")

print(person)
print(removed_value)

Output:

{'name': 'Ana', 'city': 'Lima'}
25

Use pop() when you want to remove a key and also get the removed value.

What this page helps you do #

  • Remove one key from a dictionary
  • Choose between del, pop(), and pop(key, default)
  • Avoid KeyError when the key may not exist
  • Understand what happens to the removed value

Use del when you only want to remove the key #

The del statement removes a key-value pair from a dictionary.

Use it when:

  • You only want to delete the key
  • You do not need the old value

Example:

person = {"name": "Ana", "age": 25, "city": "Lima"}

del person["age"]

print(person)

Output:

{'name': 'Ana', 'city': 'Lima'}

Important #

If the key does not exist, Python raises a KeyError.

person = {"name": "Ana", "city": "Lima"}

del person["age"]  # KeyError

If you often see this error, read how to fix KeyError when accessing dictionary values.

Use pop() when you want the removed value #

The pop(key) method removes the key and returns its value.

This is useful when you want to:

  • Save the value in a variable
  • Print the removed value
  • Use the value later in your code

Example:

person = {"name": "Ana", "age": 25, "city": "Lima"}

removed_age = person.pop("age")

print(person)
print(removed_age)

Output:

{'name': 'Ana', 'city': 'Lima'}
25

This is different from del:

  • del removes the key only
  • pop() removes the key and gives you the old value

To learn more, see the Python dictionary pop() method.

Important #

If the key does not exist, pop(key) also raises KeyError.

person = {"name": "Ana", "city": "Lima"}

person.pop("age")  # KeyError

Use pop(key, default) to avoid errors #

If you are not sure whether a key exists, use pop(key, default).

The second argument is a fallback value. Python returns it if the key is missing, instead of raising an error.

Example:

person = {"name": "Ana", "city": "Lima"}

removed_age = person.pop("age", "not found")

print(person)
print(removed_age)

Output:

{'name': 'Ana', 'city': 'Lima'}
not found

This is a safe option when:

  • The key may or may not exist
  • You want to avoid KeyError
  • You want simple code

You can also use None as the default:

person = {"name": "Ana", "city": "Lima"}

removed_age = person.pop("age", None)

print(removed_age)

Check before removing a key #

Another beginner-friendly option is to check first.

Use if key in my_dict before del or pop() when you want clear logic or want to run different code if the key is missing.

Example:

person = {"name": "Ana", "city": "Lima"}

if "age" in person:
    del person["age"]
else:
    print("The key was not found.")

print(person)

Output:

The key was not found.
{'name': 'Ana', 'city': 'Lima'}

This approach is useful when you want to:

  • Avoid errors
  • Show a message
  • Run other code if the key does not exist

If you need help with this check, see how to check if a key exists in a dictionary in Python.

Pick the right method #

Use the method that matches your situation:

  • Use del for simple removal
  • Use pop() to remove a key and return its value
  • Use pop(key, default) when the key may be missing

A quick comparison:

person = {"name": "Ana", "age": 25, "city": "Lima"}

# 1. Simple removal
del person["city"]

# 2. Remove and return value
age = person.pop("age")

# 3. Safe removal if key may be missing
country = person.pop("country", "not found")

print(person)
print(age)
print(country)

Output:

{'name': 'Ana'}
25
not found

Common mistakes #

Here are some common problems beginners run into.

Using del with a key that is not in the dictionary #

This causes a KeyError.

data = {"name": "Ana"}
del data["age"]  # KeyError

Using pop(key) without checking whether the key exists #

This also causes a KeyError.

data = {"name": "Ana"}
data.pop("age")  # KeyError

Confusing removing a key with setting its value to None #

These are not the same.

data = {"name": "Ana", "age": 25}

data["age"] = None

print(data)
print("age" in data)

Output:

{'name': 'Ana', 'age': None}
True

The key still exists. Only the value changed.

If you want to read values safely, see how to access values in a dictionary in Python.

Trying to remove multiple keys with code meant for one key #

Methods like del my_dict["key"] and my_dict.pop("key") remove one key at a time.

If you need to remove everything, use clear():

data = {"name": "Ana", "age": 25, "city": "Lima"}

data.clear()

print(data)

Output:

{}

See the Python dictionary clear() method.

FAQ #

How do I remove a key without getting an error? #

Use pop(key, default) or check with if key in my_dict first.

What is the difference between del and pop()? #

del removes the key only. pop() removes the key and returns its value.

Does setting a key to None remove it? #

No. The key still exists. Only its value changes to None.

How do I remove all keys from a dictionary? #

Use clear() to remove every key-value pair.

See also #

Press Esc to close