Built-in middleware overview in Django - Step-by-Step Execution

Concept Flow - Built-in middleware overview

Request arrives

↓

Process Request Middleware 1

↓

Process Request Middleware 2

↓

View function executes

↓

Process Response Middleware N

↓

Process Response Middleware N-1

↓

Response sent back to client

Middleware in Django wraps around requests and responses, processing them in order before and after the view runs.

Execution Sample

Django

MIDDLEWARE = [
  'django.middleware.security.SecurityMiddleware',
  'django.contrib.sessions.middleware.SessionMiddleware',
  'django.middleware.common.CommonMiddleware',
  'django.middleware.csrf.CsrfViewMiddleware',
  'django.contrib.auth.middleware.AuthenticationMiddleware',
  'django.contrib.messages.middleware.MessageMiddleware',
  'django.middleware.clickjacking.XFrameOptionsMiddleware',
]

This list shows Django's default built-in middleware that process requests and responses in order.

Execution Table

Step	Middleware Phase	Middleware Name	Action	Effect
1	Process Request	SecurityMiddleware	Check security headers	Adds security headers if missing
2	Process Request	SessionMiddleware	Load session data	Attaches session info to request
3	Process Request	CommonMiddleware	Handle URL normalization	Redirects or modifies URL if needed
4	Process Request	CsrfViewMiddleware	Check CSRF token	Blocks request if token invalid
5	Process Request	AuthenticationMiddleware	Attach user info	Adds user object to request
6	Process Request	MessageMiddleware	Prepare messages	Enables message framework
7	Process Request	XFrameOptionsMiddleware	Set X-Frame-Options header	Prevents clickjacking
8	View Execution	View Function	Process request data	Generates response
9	Process Response	XFrameOptionsMiddleware	Add headers to response	Sets X-Frame-Options header
10	Process Response	MessageMiddleware	Add messages to response	Includes messages in response
11	Process Response	AuthenticationMiddleware	Clean up	Finalizes user state
12	Process Response	CsrfViewMiddleware	Add CSRF cookie	Sets CSRF cookie in response
13	Process Response	CommonMiddleware	Modify response	Applies content transformations
14	Process Response	SessionMiddleware	Save session data	Saves session changes
15	Process Response	SecurityMiddleware	Add security headers	Ensures security headers present
16	Response Sent	Client	Receive response	Page or data shown to user

💡 All middleware processed request and response in order; response sent to client.

Variable Tracker

Variable	Start	After SecurityMiddleware	After SessionMiddleware	After CommonMiddleware	After CsrfViewMiddleware	After AuthenticationMiddleware	After MessageMiddleware	After XFrameOptionsMiddleware	After View	Final
request.headers	Initial headers	Security headers added	Session cookie loaded	URL normalized	CSRF token checked	User info attached	Messages prepared	X-Frame-Options header set	View processes request	Final headers with security and session
request.session	Empty	Empty	Loaded session data	Loaded session data	Loaded session data	Loaded session data	Loaded session data	Loaded session data	Used by view	Saved session data
request.user	Anonymous	Anonymous	Anonymous	Anonymous	User attached	User attached	User attached	User attached	Used by view	User finalized
response.headers	None	None	None	None	None	None	None	None	Created by view	Security and X-Frame headers added

Key Moments - 3 Insights

Why does middleware process requests in one order but responses in reverse?

Middleware wraps around the view like layers. Requests go in order to prepare data; responses go back through middleware in reverse to finalize or modify before sending. See execution_table steps 1-7 for request and 9-15 for response.

What happens if CsrfViewMiddleware blocks a request?

If CSRF token is invalid, CsrfViewMiddleware stops the request before the view runs (step 4). No further middleware or view executes, and an error response is sent.

How does SessionMiddleware affect request and response?

SessionMiddleware loads session data into request before the view (step 2) and saves any changes to session after the response (step 14). This keeps user session consistent.

Visual Quiz - 3 Questions

Look at the execution_table, what middleware attaches user info to the request?

A AuthenticationMiddleware

B SessionMiddleware

C CsrfViewMiddleware

D CommonMiddleware

💡 Hint

Check step 5 in the execution_table where user info is attached.

At which step does the CSRF token get checked during request processing?

A Step 3

B Step 6

C Step 4

D Step 10

💡 Hint

Look at the execution_table under Process Request phase for CSRF token check.

If SessionMiddleware did not save session data after response, what would happen?

A User info would not be attached

B Session data would not persist between requests

C CSRF token would be invalid

D Security headers would be missing

💡 Hint

Refer to variable_tracker row for request.session and step 14 in execution_table.

Concept Snapshot

Django built-in middleware are layers that process requests before the view and responses after.
They run in order on request, reverse on response.
Common middleware include Security, Session, CSRF, Authentication, and Message.
They add security headers, manage sessions, check CSRF tokens, attach user info, and handle messages.
Middleware must be ordered correctly in settings for proper behavior.

Full Transcript

Django's built-in middleware work like layers wrapping around your view. When a request comes in, it passes through each middleware in the order listed, allowing each to check or modify the request. For example, SecurityMiddleware adds security headers, SessionMiddleware loads session data, and CsrfViewMiddleware checks the CSRF token. If any middleware blocks the request, the view does not run. After the view creates a response, the response passes back through the middleware in reverse order. This lets middleware add headers or save session data before the response goes to the client. Understanding this flow helps you see how Django manages security, sessions, authentication, and messages automatically.