AttributeError: 'str' object has no attribute 'append'

AttributeError: 'str' object has no attribute 'append' means the variable in front of .append(...) holds a string, not a list. Only lists have append. Look at the line named in the traceback, then find the last assignment to that variable: it replaced a list with a string, or never was a list.

Reproduce it

python3 - <<'PY'
names = "ann"
names.append("bob")
PY

Traceback (most recent call last):
  File "<stdin>", line 2, in <module>
AttributeError: 'str' object has no attribute 'append'

python3 - <<'PY'
items = []
for word in ["a", "b"]:
    items = word
    items.append(word)
PY

Traceback (most recent call last):
  File "<stdin>", line 4, in <module>
AttributeError: 'str' object has no attribute 'append'

The second example is the common bug: the loop rebinds items to a string, so the first iteration works on the string and fails. The text in quotes is the type of the object: the same message with 'list' object has no attribute 'split' or 'dict_keys' object has no attribute 'append' has the same cause and fix.

Cause 1: the variable started as a string

Initialising an accumulator with "" is a habit from string code. When the next lines call append, Python tells you the truth: the object is a str. Decide first what you are building. A collection of items is a list. A single piece of text is a string.

Cause 2: a function returns different types

A function that returns "none found" on one path and a list on another makes every caller guess. Return the same type on every path, an empty list for no result, and keep messages out of return values.

Cause 3: the data came in as text

Values read with input(), from a file, from environment variables or from a query string are strings. If you expect several values, split them:

python3 - <<'PY'
raw = "ann,bob,cy"
names = raw.split(",")
names.append("dee")
print(names)
PY

['ann', 'bob', 'cy', 'dee']

Fix it

1. Print type(name) before the failing line, or check with isinstance(name, list).
2. Walk back to every assignment of that name and make them all produce a list, or rename the string variable.
3. When you really are building text, collect parts in a list and join them at the end:

python3 - <<'PY'
parts = []
for word in ["a", "b", "c"]:
    parts.append(word)
print("-".join(parts))
PY

a-b-c

Run the code again to confirm the traceback is gone and the output is what you expect.

Prevent it

Use clear names (names for a list, name for text) and add type hints such as names: list[str] = []. A type checker like mypy or pyright reports "str" has no attribute "append" before you run the code. The sibling error 'NoneType' object has no attribute has the same shape with a different cause: a function that returned None.

FAQ