URL Configuration Basics

What a URLconf Is

A URLconf is a Python module containing a list named urlpatterns. Each entry maps a URL pattern (as a string) to a view function that should handle requests matching it.

Example: What a URLconf Is

A URLconf is a Python module containing a list named urlpatterns. Each entry maps a URL pattern (as a string) to a view function that should handle requests matching it.

from django.urls import path
from . import views

urlpatterns = [
    path('', views.home, name='home'),
    path('about/', views.about, name='about'),
]

ROOT_URLCONF Setting

settings.py has a ROOT_URLCONF value telling Django which module contains the top-level urlpatterns list. This is usually the urls.py generated in your project folder by startproject.

Example: ROOT_URLCONF Setting

settings.py has a ROOT_URLCONF value telling Django which module contains the top-level urlpatterns list. This is usually the urls.py generated in your project folder by startproject.

ROOT_URLCONF = 'myproject.urls'

Matching Order Matters

Django walks urlpatterns from top to bottom and stops at the first pattern that matches the requested path. A broad pattern placed too early can accidentally swallow requests meant for a more specific one below it.

Note: Put more specific paths above more general ones.

Example: Matching Order Matters

Django walks urlpatterns from top to bottom and stops at the first pattern that matches the requested path. A broad pattern placed too early can accidentally swallow requests meant for a more specific one below it.

urlpatterns = [
    path('blog/latest/', views.latest_post),
    path('blog/<int:pk>/', views.post_detail),
]