Skip to content
Home / Fundamentals

Removing a Key from a Python Dictionary

A Python dictionary is a collection of key-value pairs. You can access, add, and remove items from a dictionary by referring to its keys. In this article, we will look at how to remove a key from a dictionary in Python.

Method 1: Using the pop() Method

One way to remove a key from a dictionary is to use the pop() method. The pop() method removes the specified key-value pair from the dictionary and returns the value. If the key is not found in the dictionary, the pop() method will raise a KeyError exception.

Here is an example of using the pop() method to remove a key from a dictionary:

# Create a dictionary
my_dict = {'a': 1, 'b': 2, 'c': 3}

# Remove the key 'b' from the dictionary
value = my_dict.pop('b')

# The value 2 is returned by the pop() method
print(value)

# The dictionary now contains only the keys 'a' and 'c'
print(my_dict)
2
{'a': 1, 'c': 3}

You can also specify a default value to be returned if the key is not found in the dictionary. This can be useful to avoid the KeyError exception. Here is an example:

# Create a dictionary
my_dict = {'a': 1, 'b': 2, 'c': 3}

# Remove the key 'd' from the dictionary, with a default value of 0
value = my_dict.pop('d', 0)

# The value 0 is returned as the default value
print(value)

# The dictionary remains unchanged
print(my_dict)
0
{'a': 1, 'b': 2, 'c': 3}

Method 2: Using the del Statement

Another way to remove a key from a dictionary is to use the del statement. The del statement removes the specified key-value pair from the dictionary. If the key is not found in the dictionary, the del statement will raise a KeyError exception.

Here is an example of using the del statement to remove a key from a dictionary:

# Create a dictionary
my_dict = {'a': 1, 'b': 2, 'c': 3}

# Remove the key 'b' from the dictionary
del my_dict['b']

# The dictionary now contains only the keys 'a' and 'c'
print(my_dict)
{'a': 1, 'c': 3}

Method 3: Using the popitem() Method

The popitem() method removes and returns an arbitrary key-value pair from the dictionary as a tuple. If the dictionary is empty, the popitem() method will raise a KeyError exception.

Here is an example of using the popitem() method to remove a key from a dictionary:

# Create a dictionary
my_dict = {'a': 1, 'b': 2, 'c': 3}

# Remove an arbitrary key-value pair from the dictionary
key, value = my_dict.popitem()

# The key-value pair ('c', 3) is returned as a tuple
print((key, value))

# The dictionary now contains only the keys 'a' and 'b'
print(my_dict)
('c', 3)
{'a': 1, 'b': 2}

Method 4: Using the clear() Method

The clear() method removes all key-value pairs from the dictionary.

Here is an example of using the clear() method to remove all keys from a dictionary:

# Create a dictionary
my_dict = {'a': 1, 'b': 2, 'c': 3}

# Remove all key-value pairs from the dictionary
my_dict.clear()

# The dictionary is now empty
print(my_dict)
{}