This is the opposite of the not enough values to unpack error we covered earlier. In this post, we’ll look at the “ValueError too many values” error and what causes it.
It means: “You provided more data items than you provided variable names to hold them.”
⚡ Quick Fix: ValueError: too many values to unpack (Python Unpacking Variable Count Fix)
You have more items in your sequence than variable names on the left side — match the counts, discard extras with _, or capture the remainder with *.
my_data = ["Alice", 25, "Engineer", "New York", "Python_Fan"] # Fix 1 — Match variables exactly to item count name, age, job = ["Alice", 25, "Engineer"] # Fix 2 — Discard unwanted items with _ name, age, _ = ["Alice", 25, "Engineer"] # Fix 3 — Capture unknown extras with * into a list name, *details = my_data # name = "Alice" | details = [25, "Engineer", "New York", "Python_Fan"]
The rest of the article breaks down which fix fits your data structure and when star unpacking is the cleanest solution for variable-length sequences.
The Cause
You tried to “unpack” a list or tuple into variables, but the counts didn’t match.
Problem Code:
my_data = ["Alice", 25, "Engineer"] # You only provided 2 variables (name, age) # But the list has 3 items! name, age = my_data # CRASH! ValueError: too many values to unpack (expected 2)
Fix 1: Add a Variable
If you need the data, add a variable for it.
name, age, job = my_data # Correct!
Fix 2: Use _ (The “Throwaway” Variable)
If you don’t care about the extra data (e.g., the job title), standard Python convention is to use an underscore _ as a variable name for “junk.”
name, age, _ = my_data # Correct! We ignore the 3rd item.
Fix 3: Use * (Star Unpacking)
If you have lots of extra items and you don’t know how many, use an asterisk * to grab “everything else” into a list.
my_data = ["Alice", 25, "Engineer", "New York", "Python_Fan"] # name = "Alice" # details = ["25", "Engineer", "New York", "Python_Fan"] name, *details = my_data
What This Error Exposes About Python’s Unpacking Protocol
ValueError: too many values to unpack (expected 2) is Python’s assignment system enforcing a strict count contract. Standard tuple unpacking requires an exact match between the number of variables on the left and the number of items on the right — one variable per item, no remainder allowed. The moment that count diverges in either direction, Python raises the error before assigning a single value.
The underscore convention _ is not just syntactic sugar — it is a documented Python signal that communicates intent to every developer reading your code. A variable named _ means “this value exists in the sequence but carries no meaning here.” Linters and IDEs recognize it and suppress unused-variable warnings specifically for that name. Use it whenever your sequence has a fixed structure and you need a subset of its fields.
Star unpacking *details operates on a different mechanism. Python assigns the named variables first, then collects every remaining item into a list under the starred name — regardless of how many items that remainder contains. That makes it the correct tool for variable-length sequences like API responses, CSV rows with optional trailing fields, or log entries where the prefix is structured but the suffix is not. Combine both patterns — name, age, *_ = my_data — when you need the first fields and want to explicitly discard the rest without knowing the total count.
