Python Indentation: Complete Guide with Rules & Best Practices

Proper indentation is one of the key pillars of writing clean and readable Python code. In this guide, we’ll explain everything you need to know about Python indentation, its rules, common errors, examples, and best practices for writing professional code.

1. Introduction to Python Indentation

1.1 Why Python Uses Indentation Instead of Curly Braces

In Python, indentation defines the structure of your code. Unlike languages like C, C++, or Java that use curly braces {} to mark code blocks, Python uses spaces or tabs to indicate which statements belong together.
This indentation is mandatory — it’s part of Python’s syntax. Each indentation level represents a block of code (also called a suite), and every statement inside that block must be consistently indented.
In Python, indentation defines the structure of your code. Unlike languages like C, C++, or Java that use curly braces {} to mark code blocks, Python uses spaces or tabs to indicate which statements belong together.
Proper indentation ensures your code is readable, structured, and professional.

if True:
    print("True")
else:
    print("False")

Explanation:

Both print() statements are properly indented under the if and else clauses, showing their association clearly.

2. Importance of Proper Indentation in Python Code

Python relies entirely on indentation to understand program structure. If indentation is missing or inconsistent, your program will fail to run.

# Correct
if True:
    print("Hello")  # belongs to 'if'
# Incorrect
if True:
print("Hello")  # SyntaxError

Explanation:In the correct version, print() is properly aligned under the if block. The second version raises a SyntaxError due to missing indentation.

3. How Python Indentation Works: Rules and Guidelines

• Python does not use curly braces {} or keywords like begin and end to define blocks.
• Indentation marks the beginning and end of a code block — like in functions, loops, and conditionals.
• Every statement inside the same block must be indented consistently (usually 4 spaces).
• Using tabs and spaces inconsistently will cause errors. PEP 8 recommends spaces.

3.1 Python Indentation Rules

4. Python Indentation Examples: If Blocks, Loops, Functions & Classes

4.1 Using Indentation in If Blocks

if True:
    print("This is indented")
    print("Part of the same block")

print("This is outside the block")

#Output:
This is indented
Part of the same block
This is outside the block

Explanation:

• Both statements inside if are indented equally and belong to the same block.
• The last print is not indented, so it’s outside the if block.

4.2 Using Indentation in Loops

#Output:
for i in range(3):
    print("Loop:", i)
    print("Square:", i ** 2)

Output:
Loop: 0
Square: 0
Loop: 1
Square: 1
Loop: 2
Square: 4

Explanation:
Indentation shows that both print statements belong to the same for loop block.

4.3 Function and Nested Block Indentation

# Function Block
def greet(name):
    print("Hello,", name)

# Nested If + Loop
for i in range(3):
    if i % 2 == 0:
        print(i, "is even") 

Explanation:

• The first print is part of the greet() function.
• Nested blocks show two levels: the for loop and the if statement inside it.

4.4 Class Methods and Indentation

class Car:
    def __init__(self, model):
        self.model = model

    def drive(self):
        print(self.model, "is driving") 

Explanation:

• Methods are indented inside the class.
• Statements inside methods are further indented to define their block hierarchy.

4.5 Common Incorrect Indentation Examples

if 5 > 3:
print("Will cause an error")  # IndentationError

#Output:
IndentationError: expected an indented block

Explanation: Python raises an error because the second line isn’t indented properly.

5. Python Whitespace and Formatting: Best Practices

# Good
x = 5
print(x + 3)

# Bad
x=5
print( x+3 )

Explanation: Good formatting improves readability and follows PEP 8 standards.

6. Common Python Indentation Errors and Fixes  

def test():
 print("Hello")
   print("World")   # Extra spaces → IndentationError

if True:
print("Oops")   # Not indented

Tip: Use editors like VS Code, PyCharm, or Jupyter Notebook — they auto-indent and highlight errors.

7. Python Suites: Grouping Statements with Indentation

Definition:
A suite is a group of statements controlled by a clause such as if, for, def, or class. Python defines suites using indentation instead of curly braces.

# If Suite
if score >= 90:
    print("Excellent!")
    reward = "Gold Medal"

# Def Suite
def show_info():
    print("Name: Alice")
    print("Age: 25")

# Invalid Example
def show_info():
print("Name: Alice")  # IndentationError

8. Conclusion: Mastering Python Indentation for Clean, Readable Code

• Indentation defines code structure and logic flow in Python.
• Every class, function, and control block depends on proper indentation.
• Following PEP 8 indentation standards ensures professional, readable, and maintainable code.
• Even advanced Python scripts rely on these basics — mastering indentation is key to writing elegant, error-free Python code.

Pro Tip: Think of indentation as Python’s grammar — if it’s wrong, your code “sentence” won’t make sense.