If you are a developer working in a Python language, for sure you may have encountered the typeerror tuple indices must be integers or slices not str.
This error can be frustrating, especially when you are not sure what it means or how to fix it.
In this article, we will explain to you the tuple indices must be integers or slices not str in more detail.
Also, provide some tips on how to resolve it.
What is a Tuple?
Before we proceed into the TypeError, it is important to know first what a tuple is.
In Python language, a tuple is an ordered collection of items. It is similar to a list, yet tuples are immutable.
That means that their contents cannot be able to change once they are created.
Why this error occur?
The tuple indices must be integers or slices not str error occurs because you are trying to access an element in a tuple using a string as the index.
Alternatively, tuples can only be accessed using integer indices or slices.
For example, let’s say you have the following tuple:
my_tuple = ('chocolate', 'strawberry', 'vanilla')
print(my_tuple['0'])Output:
C:\Users\Dell\PycharmProjects\pythonProject\venv\Scripts\python.exe C:\Users\Dell\PycharmProjects\pythonProject\main.py
Traceback (most recent call last):
File “C:\Users\Dell\PycharmProjects\pythonProject\main.py”, line 2, in
print(my_tuple[‘0’])
TypeError: tuple indices must be integers or slices, not str
If you are trying to access the first element of the tuple using a string index.
You will get the “tuple indices must be integers or slices, not str” error message.
This is because the index ‘0’ is a string, not an integer.
Common Causes of the Error
There are multiple common causes of the error when working with tuples:
- It is possible you are using a String Index.
- You misspelled the Index.
- You are trying to use a Variable as the Index.
- It’s possible you’re trying to Modify a Tuple.
Also, read the other python error resolved:
- Typeerror: only absolute urls are supported
- typeerror: iteration over a 0-d array
- Typeerror: super expression must either be null or a function
How to solve the tuple indices must be integers or slices not str?
Now that you already understand some of the common causes of the error, let’s take a look at how to solve it.
Here are a few solutions to solve the error:
Solution 1: Use Integer Indices or Slices
The simple way to solve this error is to make sure that you are using integer indices or slices when accessing elements in a tuple.
For example, we will use the same example above
my_tuple = ('chocolate', 'strawberry', 'vanilla', 'butter', 'cheese')To access an individual element of the tuple, you can use an integer below:
print(my_tuple[0])
'chocolate'
print(my_tuple[3])
'vanilla'Let’s take an example:
my_tuple = ('chocolate', 'strawberry', 'vanilla')
print(my_tuple[0])
'chocolate'In the first example, my_tuple[0] returns the first element of the tuple (‘chocolate’) because the index 0 is an integer.
So the output will be a chocolate:
C:\Users\Dell\PycharmProjects\pythonProject\venv\Scripts\python.exe C:\Users\Dell\PycharmProjects\pythonProject\main.py
chocolate
However, to access a slice of the tuple, you can use a slice with two integer indices:
print(my_tuple[1:4])
('strawberry', 'vanilla', 'butter')In the second example, my_tuple[1:4] returns a slice of the tuple that includes elements with indices 1, 2, and 3 (‘strawberry’, ‘vanilla’, ‘butter’, respectively).
Let’s take a look another example:
my_tuple = ('chocolate', 'strawberry', 'vanilla', 'butter', 'cheese')
print(my_tuple[1:4])
('strawberry', 'vanilla', 'butter')Output:
C:\Users\Dell\PycharmProjects\pythonProject\venv\Scripts\python.exe C:\Users\Dell\PycharmProjects\pythonProject\main.py
(‘strawberry’, ‘vanilla’, ‘butter’)
Through using integer indices or slices, you can prevent the “TypeError: tuple indices must be integers or slices, not str” error.
Solution 3: Check Your Spelling
If you are getting the error due to a misspelled index.
Remember always that you need to double-check your spelling to make sure that you are using the correct index.
Solution 4: Convert Variables to Integers
When you are trying to use a variable as the index, make sure that you convert it to an integer first.
For example:
We assume you have a tuple of numbers:
my_tuple = (10, 20, 30, 40, 50)And you have a variable that consists a string that defines an integer:
my_index = '2'Example: the output will be an error
my_tuple = (10, 20, 30, 40, 50)
my_index = '2'
print(my_tuple[my_index])Output:
C:\Users\Dell\PycharmProjects\pythonProject\venv\Scripts\python.exe C:\Users\Dell\PycharmProjects\pythonProject\main.py
Traceback (most recent call last):
File “C:\Users\Dell\PycharmProjects\pythonProject\main.py”, line 3, in
print(my_tuple[my_index])
TypeError: tuple indices must be integers or slices, not str
If you are trying to use the my_index variable as an index directly, you will get a “TypeError tuple indices must be integers or slices, not str” error:
To solve this error, you can convert the my_index variable to an integer using the int() function:
For the correct example:
my_tuple = (10, 20, 30, 40, 50)
my_index = '3'
print(my_tuple[int(my_index)])Output:
C:\Users\Dell\PycharmProjects\pythonProject\venv\Scripts\python.exe C:\Users\Dell\PycharmProjects\pythonProject\main.py
40
In this example, int(my_index) returns the integer value 3.
Which is used as the index to access the third element of the my_tuple tuple (40).
By converting the string variable to an integer before using it as an index, you can prevent the error.
Solution 3: Use Lists Instead of Tuples
If you need to change the contents of a collection, you can use a list instead of a tuple.
Lists are similar to tuples, yet they are mutable, it means that you can change their contents.
Suppose you have a tuple of numbers:
my_tuple = (10, 20, 30, 40, 50)
my_tuple[1] = 25And you want to change one of the elements of the tuple (e.g., change the second element from 20 to 25). Tuples are immutable, so you cannot modify their elements directly.
If you try to do so, you will get a “TypeError: ‘tuple’ object does not support item assignment” error:
C:\Users\Dell\PycharmProjects\pythonProject\venv\Scripts\python.exe C:\Users\Dell\PycharmProjects\pythonProject\main.py
Traceback (most recent call last):
File “C:\Users\Dell\PycharmProjects\pythonProject\main.py”, line 2, in
my_tuple[1] = 25
TypeError: ‘tuple’ object does not support item assignment
To solve this error, you can use a list instead of a tuple.
Lists are mutable, so you can change their elements directly.
Here’s how you can create a list from the tuple:
my_list[1] = 25And if you want to convert the list back to a tuple, you can use the tuple() function:
my_new_tuple = tuple(my_list)Now my_new_tuple is a tuple with the changed element:
print(my_new_tuple)
(10, 25, 30, 40, 50)Let’s take a complete example below;
my_tuple = (10, 20, 30, 40, 50)
my_list[1] = 25
my_new_tuple = tuple(my_list)
print(my_new_tuple)
(10, 25, 30, 40, 50)Output:
C:\Users\Dell\PycharmProjects\pythonProject\venv\Scripts\python.exe C:\Users\Dell\PycharmProjects\pythonProject\main.py
(10, 25, 30, 40, 50)
By using a list instead of a tuple, you can change its elements directly and you can prevent the error.
FAQs
No, you cannot use a string index to access elements in a tuple. Tuples can only be accessed using integer indices or slices.
No, tuples are immutable, which means that their contents cannot be changed once they are created.
Lists and tuples are both collections of items in Python. The main difference between them is that lists are mutable, while tuples are immutable.
Frequently Asked Questions
What is Python TypeError and what causes it?
TypeError is raised when an operation is applied to an object of the wrong type. Common patterns: calling a non-callable object, adding incompatible types (str + int), passing the wrong number of arguments, or accessing attributes on a NoneType. Each TypeError message names the operation and expected vs actual types, the fix is almost always to convert types explicitly (int(), str()) or fix the wrong variable assignment.
How do I quickly debug a Python TypeError?
Three steps: (1) Read the full error message, it names the exact operation and types involved. (2) Print the type of every variable in that line: print(type(var1), type(var2)). (3) Check what the function expected vs what you passed. Most TypeError fixes are 1-line type casts or fixing a variable that became None unexpectedly.
Should I catch TypeError or let it propagate?
For internal code, let TypeError propagate, it’s almost always a real bug (wrong type passed). For boundary code (parsing user input, third-party API responses), catch TypeError + ValueError together: try: parsed = int(value) except (TypeError, ValueError): parsed = 0. Catching internal TypeErrors hides bugs.
How do I prevent TypeError in production?
Three patterns: (1) Use type hints (def add(a: int, b: int) -> int) and check with mypy / pyright in CI. (2) Validate inputs at boundaries (Pydantic for FastAPI, DRF serializers for Django). (3) Default values that match expected types (return 0 not None for numeric functions). Static typing catches 80% of TypeErrors before runtime.
Where can I find more TypeError fixes?
Browse the TypeError reference hub for 220+ specific TypeError fixes. For broader Python debugging, see the Python Tutorial hub. For related error types, see ValueError and AttributeError guides.
Conclusion
The “tuple indices must be integers or slices, not str” can be confusing.
Yet it is usually easy to solve once you know the cause of the error.
In most cases, it is caused by using a string index instead of an integer index or slice.
By using the solutions provided in this article, you should be able to solve the error quickly and easily.
