Python casefold() Method

What You’ll Learn

The casefold() method returns a case-folded version of a string, optimized for case-insensitive comparisons. Added in Python 3.3, it looks similar to lower(), but uses stronger Unicode rules—making it the right choice when you need reliable matching across different letter cases and international text.

Definition and Usage

In Python, casefold() is a string method that returns a copy of the string with case distinctions removed as aggressively as possible. Case folding is a Unicode process used when you want two strings to compare equal regardless of uppercase or lowercase differences. For example, comparing "PYTHON" and "python" becomes straightforward: both become "python" after casefold().

📝 Syntax

The casefold() method takes no parameters:

string.casefold()

Syntax Rules

• string — any valid Python str object.
• Return value — a new case-folded str; the original is never modified.
• No arguments — passing arguments raises TypeError.
• Empty string — returns "" without error.
• Python 3.3+ — available in modern Python 3; not in Python 2.

Examples Gallery

Run these examples in Python 3.3 or later. Each one demonstrates a practical pattern for case-insensitive string handling.

original = "HELLO"
folded = original.casefold()

print("Original:", original)
print("Casefolded:", folded)

Original: HELLO
Casefolded: hello

answer = "PyThOn"

if answer.casefold() == "python":
    print("Correct! Case did not matter.")
else:
    print("Try again.")

Correct! Case did not matter.

titles = [
    "Case-Insensitive Search",
    "Python String Methods",
    "Working with Unicode"
]
query = "UNICODE"

for title in titles:
    if query.casefold() in title.casefold():
        print("Match found:", title)

Match found: Working with Unicode

word_a = "Straße"
word_b = "STRASSE"

print("lower():   ", word_a.lower() == word_b.lower())
print("casefold():", word_a.casefold() == word_b.casefold())

lower():    False
casefold(): True

users = {
    "alice": "Alice Smith",
    "bob": "Bob Jones"
}

def lookup(name):
    return users.get(name.casefold(), "User not found")

print(lookup("ALICE"))
print(lookup("BoB"))

Alice Smith
Bob Jones

🚀 Common Use Cases

• Password or keyword checks — compare answers without rejecting valid casing variants.
• Search filters — find substrings in titles, tags, or filenames case-insensitively.
• Username lookups — treat "Admin" and "admin" as the same account key.
• Data deduplication — normalize text before checking for duplicates.
• International text — compare Unicode strings more reliably than plain lower().

📝 Notes

• casefold() is for comparison and normalization, not for pretty display—use capitalize() or title() when formatting text for users.
• For most English-only ASCII strings, lower() and casefold() return the same result, but casefold() is still the better choice for equality checks.
• It does not remove accents or whitespace—only case distinctions are folded.
• Always case-fold both sides of a comparison for consistent results.

💡 Best Practices