Python Indentation: Complete Guide with Rules & Best Practices

By / November 2, 2025

Proper Python indentation is one of the key pillars of writing clean and readable Python code. In this guide, we explain Python indentation, its rules, common errors, practical examples, and best practices for writing professional Python programs.

1. What is Indentation in Python?

Python indentation refers to the spaces or tabs placed at the beginning of a line of code to define code blocks. Unlike many other programming languages that use braces {} to group statements, Python relies entirely on indentation to determine the structure and flow of the program.

Indentation is not just a style choice in Python; it is a core part of the language syntax. If indentation is missing or inconsistent, Python raises an error instead of executing the program.

2. Why Python Uses Indentation Instead of Curly Braces (And Why Indentation Matters)

Python uses indentation to define code blocks, making program structure visually clear and eliminating the need for curly braces {} used in languages like C, C++, or Java. Instead of symbols, Python relies on spaces or tabs to indicate which statements belong together.

2.1 How Indentation Defines Code Blocks in Python

In Python, indentation is not optional—it is part of the language syntax. Each level of indentation represents a block of code (also called a suite), and all statements within that block must be consistently aligned. 

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

Both print() statements are indented under their respective if and else clauses, clearly defining their logical association.

2.2 Importance of Proper Indentation in Python Code

Because Python relies entirely on indentation to understand program structure, even a small indentation mistake can cause the program to fail. Incorrect or missing indentation leads to syntax or runtime errors. 

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

# Incorrect
if True:
print("Hello")  # SyntaxError
Explanation:

The second example raises a SyntaxError because the statement is not indented correctly, breaking Python’s block structure.

3. How Python Indentation Works: Rules and Guidelines

  • Python does not use curly braces or begin–end keywords.
  • Indentation defines blocks in functions, loops, and conditionals.
  • Each block must use consistent spacing, usually 4 spaces.
  • Mixing tabs and spaces breaks Python indentation rules.

Python Indentation Rules

Python uses indentation to define code blocks instead of braces. Following these indentation rules helps prevent syntax errors and improves code readability.

Rule Explanation
Use 4 spaces Each indentation level should use exactly four spaces.
Spaces over tabs PEP 8 recommends using spaces instead of tabs.
Consistent indentation All statements in the same block must align evenly.
Top-level code Code outside blocks starts at column zero.

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

Understanding indentation rules becomes much easier when you see them applied in real code. In this section, we’ll walk through practical Python indentation examples covering common control structures such as if statements, loops, functions, and classes. These examples show how indentation controls program flow and prevents logical errors.

4.1 Using Indentation in If Blocks

Conditional statements rely heavily on indentation to determine which lines of code execute when a condition is true or false. Every statement inside an if block must be indented consistently to belong to that condition.

Example: Correct Indentation in an If Statement


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

print("This is outside the block")
Explanation:
  • Both print statements are indented and therefore execute when the condition is true.
  • The last print statement is not indented, so it runs independently of the if block.

4.2 Using Indentation in Loops

Loops use indentation to define which statements repeat during each iteration. Any line aligned under the loop header becomes part of the loop body and executes repeatedly.

Example: Indentation Inside a For Loop


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

Both print statements are indented at the same level, showing that they execute together during each loop iteration. If one line were misaligned, it would either raise an error or run outside the loop.

4.3 Function and Nested Block Indentation

Functions and nested control structures introduce multiple indentation levels. Each new block adds another level of indentation, making the logical structure of the program clear and readable.

Example: Function Definition with Nested Blocks


def greet(name):
    print("Hello,", name)

for i in range(3):
    if i % 2 == 0:
        print(i, "is even")
Explanation:
  • The print statement inside greet() is indented once, defining the function body.
  • The if statement is nested inside the for loop, creating a second indentation level.

4.4 Class Methods and Indentation

Classes rely on indentation to separate methods from the class definition. Each method inside a class must be indented, and statements inside methods require additional indentation.

Example: Class Definition with Proper Indentation


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

    def drive(self):
        print(self.model, "is driving")
Explanation:
  • Both methods are indented inside the class definition.
  • Statements inside each method form a deeper indentation level.

4.5 Common Incorrect Indentation Examples

Incorrect indentation is one of the most common causes of Python errors. Even a single missing space can prevent the program from running.

Example: Missing Indentation After a Condition


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

Python raises an IndentationError because the statement following the if condition is not indented. Python expects an indented block after every colon (:).

5. Python Whitespace and Formatting: Best Practices

Proper Python whitespace handling complements indentation to improve readability. Python also considers additional whitespace elements in code formatting, which help make programs easier to read and maintain.

  • Spaces after commas
  • Spaces around operators (=, +, -)
  • Avoid trailing spaces at the end of lines

# 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

Error Type Example / Fix
Mixing tabs and spaces Use only spaces to avoid invisible mismatches
Inconsistent indentation 
def test():
 print("Hello")
   print("World")   
# Extra spaces → IndentationError
Forgetting indentation after control statements 
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 Python indentation rules is essential for writing clean, 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.

Leave a Comment

Your email address will not be published. Required fields are marked *

Scroll to Top