URL parameter type converters in Django - Step-by-Step Execution

Concept Flow - URL parameter type converters

Define URL pattern with converter

↓

Request URL received

↓

Django matches URL pattern

↓

Extract parameter using converter

↓

Pass converted parameter to view

↓

View uses parameter as correct type

Django reads the URL pattern, uses the converter to extract and convert the parameter, then passes it to the view as the right type.

Execution Sample

Django

from django.urls import path

urlpatterns = [
    path('item/<int:item_id>/', view_func),
]

Defines a URL pattern that captures an integer parameter 'item_id' and passes it to the view.

Execution Table

Step	URL Pattern	Request URL	Converter Used	Parameter Extracted	Parameter Type	Action
1	'item/<int:item_id>/'	'item/42/'	int	42	int	Match pattern and extract parameter
2	'item/<int:item_id>/'	'item/42/'	int	42	int	Pass 42 as int to view_func
3	'item/<int:item_id>/'	'item/abc/'	int	N/A	N/A	No match, 404 error
4	'item/<slug:slug>/'	'item/hello-world/'	slug	hello-world	str	Pass 'hello-world' as string to view_func

💡 Execution stops when URL matches pattern and parameter is converted, or 404 if no match.

Variable Tracker

Variable	Start	After Step 1	After Step 2	After Step 3	After Step 4
item_id	None	42 (int)	42 (int)	None (no match)	N/A
slug	None	N/A	N/A	N/A	'hello-world' (str)

Key Moments - 2 Insights

Why does 'item/abc/' not match the pattern 'item/<int:item_id>/'?

Because the converter 'int' only accepts digits. 'abc' is not digits, so Django does not match and returns 404. See execution_table row 3.

What type does the 'slug' converter produce?

The 'slug' converter extracts a string matching letters, numbers, hyphens, and underscores. It passes it as a string to the view. See execution_table row 4.

Visual Quiz - 3 Questions

Look at the execution table, what is the parameter type passed to the view for URL 'item/42/'?

A slug

B str

C int

D None

💡 Hint

Check execution_table row 2 under 'Parameter Type'

At which step does the URL 'item/abc/' fail to match the pattern?

A Step 1

B Step 3

C Step 2

D Step 4

💡 Hint

Look at execution_table row 3 where 'Parameter Extracted' is 'N/A'

If we change the converter from <int:item_id> to <slug:item_id>, what happens to the URL 'item/abc/'?

A It matches and passes 'abc' as string

B It still fails to match

C It matches but passes as int

D It causes a server error

💡 Hint

Refer to variable_tracker row for 'slug' and execution_table row 4

Concept Snapshot

Django URL converters extract and convert URL parts.
Syntax: path('route/<converter:name>/', view).
Common converters: int, str, slug, uuid, path.
Converted parameter is passed to view as correct type.
If no match, Django returns 404 error.

Full Transcript

In Django, URL parameter type converters help extract parts of the URL and convert them to the right type before passing to the view. For example, using <int:item_id> means Django looks for digits in that part of the URL and converts it to an integer. If the URL matches, the view receives the parameter as an int. If it doesn't match, Django returns a 404 error. Other converters like slug accept letters, numbers, hyphens, and underscores and pass them as strings. This process ensures views get parameters in the expected type, making code simpler and safer.