String manipulation in Python sometimes fails with the error that you can only concatenate str, not int to str. This error appears when you try to combine a string with an integer using the plus sign.
It’s a common mistake for beginners and even experienced developers. The error message is clear, but knowing how to fix it quickly saves time.
In this article, you’ll learn why this error happens and how to solve it. We’ll cover multiple methods, real examples, and best practices.
What Does Can Only Concatenate Str Not Int To Str Mean
This error occurs when you use the + operator between a string and an integer. Python treats the plus sign differently for strings and numbers.
For strings, + means concatenation (joining text). For integers, + means addition. Python can’t decide which one you want when you mix types.
Here’s a simple example that triggers the error:
name = "Alice"
age = 30
message = "Hello, " + name + " you are " + age + " years old."This code will raise: TypeError: can only concatenate str (not "int") to str. The variable age is an integer, not a string.
Common Scenarios That Trigger This Error
Printing Variables Without Conversion
You often see this error when printing messages that include numbers.
score = 95
print("Your score is " + score)The score variable is an integer. Python expects a string on both sides of the +.
Building Strings With User Input
User input from input() is always a string. But if you convert it to an integer and then try to concatenate, the error appears.
age = int(input("Enter your age: "))
print("You are " + age + " years old.")Here age is an integer after conversion, so concatenation fails.
Working With Lists Or Tuples
Sometimes you extract a number from a list and try to combine it with a string.
data = [100, "points"]
print("Total: " + data[0])The first element is an integer, causing the error.
How To Fix Can Only Concatenate Str Not Int To Str
There are several ways to fix this error. Choose the method that fits your code best.
Method 1: Convert Integer To String With Str()
The simplest fix is to wrap the integer in str(). This converts the number to a string before concatenation.
age = 30
message = "You are " + str(age) + " years old."
print(message)Now both sides of the + are strings. The error disappears.
You can also convert multiple integers:
year = 2025
month = 3
day = 15
date = str(month) + "/" + str(day) + "/" + str(year)
print(date)Method 2: Use F-Strings (Python 3.6+)
F-strings are the modern way to combine strings and variables. They automatically convert numbers to strings.
name = "Bob"
score = 88
print(f"{name} scored {score} points.")No need to call str(). Just put the variable inside curly braces.
F-strings also support expressions:
total = 150
count = 3
print(f"Average: {total / count:.2f}")Method 3: Use Format() Method
The format() method works in older Python versions too. It converts integers automatically.
name = "Carol"
age = 25
print("{} is {} years old.".format(name, age))You can also use positional or named arguments:
print("{0} is {1} years old.".format(name, age))
print("{n} is {a} years old.".format(n=name, a=age))Method 4: Use Comma In Print()
The print() function can take multiple arguments separated by commas. It adds a space between them automatically.
score = 95
print("Your score is", score)This works because print() converts each argument to a string internally. But it adds a space, which may not be what you want.
Method 5: Use Percent Formatting
Old-style formatting with % also works. Use %s as a placeholder for strings.
name = "Dave"
age = 40
print("%s is %d years old." % (name, age))%d is for integers, %s for strings. Python converts automatically.
Advanced Examples And Edge Cases
Concatenating Multiple Types
Sometimes you have floats, booleans, or other types mixed with strings.
price = 19.99
quantity = 3
total = price * quantity
print("Total cost: " + str(total))Always convert non-string types to string before concatenation.
Working With None Values
If a variable is None, you’ll get a different error. But if you try to concatenate None with a string, it also fails.
value = None
print("Value is " + value) # TypeErrorFix by converting to string or using f-strings:
print(f"Value is {value}")This prints “Value is None” without error.
Using Join() With Mixed Types
The join() method expects all elements to be strings. If you have integers, convert them first.
items = [1, 2, 3]
# This fails:
# print(", ".join(items))
# Fix:
print(", ".join(str(x) for x in items))Database Or API Responses
When you fetch data from a database or API, numbers often come as integers. Always check the type before concatenation.
user_id = 12345
print("User ID: " + str(user_id))Best Practices To Avoid This Error
Use F-Strings By Default
F-strings are readable, fast, and handle type conversion automatically. They reduce the chance of this error.
name = "Eve"
age = 28
print(f"{name} is {age}")Check Variable Types With Type()
If you’re unsure about a variable’s type, use type() to check.
value = some_function()
print(type(value)) # or This helps you decide if conversion is needed.
Use Try-Except For Robust Code
If you expect mixed types, wrap concatenation in a try-except block.
try:
result = "Value: " + value
except TypeError:
result = "Value: " + str(value)Convert Early In Pipelines
When processing data, convert integers to strings as soon as possible. This avoids errors later.
def format_user(name, age):
age_str = str(age)
return f"{name} is {age_str} years old."Debugging Tips For This Error
Read The Full Error Message
Python tells you which line caused the error and what types are involved. Look for the line number.
Traceback (most recent call last):
File "test.py", line 5, in
print("Age: " + age)
TypeError: can only concatenate str (not "int") to str The message says age is an integer. That’s your clue.
Use Print Statements To Debug
Print the type of each variable before concatenation.
print(type(name)) #
print(type(age)) # Check For Hidden Integers
Sometimes a variable looks like a string but is actually an integer. For example, from a function return.
def get_count():
return 10
count = get_count()
print("Count: " + count) # ErrorAlways verify return types from functions.
Real-World Examples
Building A User Profile String
first_name = "John"
last_name = "Doe"
age = 35
city = "New York"
# Wrong:
# profile = first_name + " " + last_name + " is " + age + " from " + city
# Correct:
profile = f"{first_name} {last_name} is {age} from {city}"
print(profile)Creating A File Path
folder = "/data/"
file_id = 42
extension = ".csv"
# Wrong:
# path = folder + file_id + extension
# Correct:
path = folder + str(file_id) + extension
print(path)Formatting A Price List
items = [("apple", 1.50), ("banana", 0.75), ("cherry", 2.00)]
for item, price in items:
print(f"{item}: ${price:.2f}")No concatenation needed, so no error.
Common Mistakes And How To Avoid Them
Forgetting To Convert After Input()
When you use input(), the result is always a string. If you need a number, convert it. But then don’t forget to convert back for concatenation.
age_str = input("Enter age: ")
age_int = int(age_str)
print("You are " + str(age_int) + " years old.")Mixing Concatenation And Addition
If you have a string and a number, Python doesn’t know if you want to add or concatenate. Be explicit.
# Ambiguous:
# result = "Total: " + 10 + 5
# Correct:
result = "Total: " + str(10 + 5)Using + With Non-String Iterables
The + operator works for lists and tuples too. But mixing types still fails.
list1 = [1, 2, 3]
list2 = ["a", "b"]
# This works:
combined = list1 + list2
# But if you try to concatenate a string with a list:
# "data" + list1 # ErrorPerformance Considerations
For small strings, any method works fine. For large-scale concatenation, f-strings and str() are efficient.
Avoid using + in loops for many strings. Use join() instead.
# Slow:
result = ""
for i in range(1000):
result += str(i)
# Fast:
result = "".join(str(i) for i in range(1000))Frequently Asked Questions
Why Does Python Not Automatically Convert Int To Str During Concatenation?
Python prioritizes type safety. Automatic conversion could hide bugs, like when you intend to add numbers but accidentally concatenate strings. The error forces you to be explicit.
Can I Concatenate A String With A Float?
No, the same error occurs with floats. You must convert the float to a string using str() or use f-strings.
What Is The Difference Between Str() And Repr() For Conversion?
str() gives a human-readable string. repr() gives a string that could recreate the object. For integers, they are the same. For floats, repr() may show more precision.
How Do I Concatenate A String With A Boolean?
Booleans True and False are integers in Python. Convert them with str() or use f-strings.
flag = True
print("Flag is " + str(flag))Does This Error Occur In Other Programming Languages?
Yes, many languages have similar type errors. JavaScript, for example, converts automatically, which can lead to unexpected results. Python’s explicit approach is safer.
Summary
The error “can only concatenate str not int to str” is easy to fix once you understand it. Always ensure both sides of the + operator are strings when concatenating.
Use str(), f-strings, format(), or commas in print() to avoid the error. F-strings are the most readable and modern solution.
Check variable types with type() when debugging. Convert early in your code to prevent the error from spreading.
With these techniques, you can handle string concatenation confidently and avoid this common Python pitfall.