Python Dict Delete Key: Methods and Examples

Do you need the removed value, or should the original dictionary stay intact? The pop method returns the value it removes, while del removes the entry.

The article compares those methods with a filtered copy and shows how pop handles a missing key.

TL;DR

Use dict.pop() to remove a key and receive its value, del when its presence is required, and a filtered copy when the original must stay intact.

• Use pop(key, default) when a missing key is expected.
• Use clear() to empty a dictionary without removing its variable.
• Do not change a dictionary’s size while iterating over it directly.

What Is a Python Dictionary Entry?

A dictionary entry pairs a unique key with a value, and removing it takes away that association. Other pairs remain available for later updates.

Python has in-place methods and a comprehension that builds a separate dictionary. The choice depends on one question: should other code see the original mapping change?

For exact method behavior, consult the official dict documentation. AskPython’s dictionary tutorial covers creating and accessing entries. Its key existence guide explains membership checks.

How to Remove Dictionary Entries Step by Step

For one known key, choose pop() if the removed value matters. It returns that value while removing its entry.

Step 1: Remove a key with pop()

Call pop() with the key when the removed value will be used next. The program also tests a default for an absent key, filters entries, removes the final inserted pair, and empties the mapping.

scores = {"Ada": 94, "Grace": 91, "Lin": 82}
removed = scores.pop("Grace")
print("removed:", removed)
print("after pop:", scores)
scores.pop("Max", None)
print("after missing key:", scores)

for name in list(scores):
    if scores[name] < 90:
        del scores[name]
print("after filtering:", scores)

last = scores.popitem()
print("popitem:", last)
print("after popitem:", scores)
scores.clear()
print("after clear:", scores)

removed: 91
after pop: {'Ada': 94, 'Lin': 82}
after missing key: {'Ada': 94, 'Lin': 82}
after filtering: {'Ada': 94}
popitem: ('Ada', 94)
after popitem: {}
after clear: {}

The returned value is 91, and the missing-key call leaves the mapping unchanged. I use list(scores) to snapshot the keys before filtering. That prevents a size-change error.

Step 2: Use del when the key must exist

Write del scores[“Ada”] to remove a known entry when its value is not needed. Chained subscripts also remove a nested entry, such as del user[“settings”][“theme”], while leaving the surrounding dictionaries present.

Step 3: Build a dictionary without selected keys

A comprehension creates a new mapping, which is useful when the original must remain unchanged or the rule selects several entries.

scores = {"Ada": 94, "Grace": 91, "Lin": 82}
kept = {name: score for name, score in scores.items() if score >= 90}

The result contains Ada and Grace, while the original scores mapping still contains Lin. A multiple-key rule can test whether each key is outside the removal set.

Edge Cases When Deleting Dictionary Keys

Missing keys and mutation during iteration require an explicit choice. The table shows the behavior to expect and the safer response.

Without a default, pop() and del both raise KeyError for an absent key. Use a unique sentinel rather than None when None could also be a valid stored value, so the caller can tell absence from a removed None value.

popitem() removes the last inserted pair in modern Python dictionaries and returns a (key, value) tuple. It does not choose a random key. The del statement can also remove the variable binding itself.

By contrast, clear() empties the object. Other references to that dictionary then observe an empty mapping.

For conditional deletion in place, first make a list of matching keys, then remove those keys in a second loop. This prevents a size change during direct iteration.

Conclusion

Use the method that matches the key’s expected presence and whether the source mapping must remain intact. The Python dict reference and the AskPython guides to dict.items() provide details for related operations.

FAQ

These answers address common choices when removing dictionary entries.