Getting started with Django

<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name="viewport" content="width=device-width, initial-scale=1"> <meta name="ROBOTS" content="ALL" /> <meta name="MSSmartTagsPreventParsing" content="true" /> <meta name="Copyright" content="Django Software Foundation" /> <meta name="keywords" content="Python, Django, framework, open-source" /> <meta name="description" content="" />  <link rel="apple-touch-icon" href="https://static.djangoproject.com/img/icon-touch.e4872c4da341.png"> <link rel="icon" sizes="192x192" href="https://static.djangoproject.com/img/icon-touch.e4872c4da341.png"> <link rel="shortcut icon" href="https://static.djangoproject.com/img/favicon.6dbf28c0650e.ico"> <meta name="msapplication-TileColor" content="#113228"> <meta name="msapplication-TileImage" content="https://static.djangoproject.com/img/icon-tile.b01ac0ef9f67.png"> <meta name="theme-color" content="#0C4B33"> <meta property="og:title" content="Getting started with Django" /> <meta property="og:description" content="It's quick & easy to get up and running with Django" /> <meta property="og:image" content="https://static.djangoproject.com/img/logos/django-logo-negative.1d528e2cb5fb.png" /> <meta property="og:image:alt" content="Django logo" /> <meta property="og:image:width" content="1200" /> <meta property="og:image:height" content="546" /> <meta property="og:image:type" content="image/png" /> <meta property="og:url" content="https://www.djangoproject.com/start/" /> <meta property="og:site_name" content="Django Project" /> <meta property="twitter:creator" content="djangoproject" /> <meta property="twitter:site" content="djangoproject" /> <meta property="twitter:card" content="summary"> <title>Getting started with Django | Django</title> <link rel="stylesheet" href="https://static.djangoproject.com/css/output.24dee103147c.css" > <script src="https://static.djangoproject.com/js/mod/switch-dark-mode.bd4be131d69b.js"></script> </head> <body id="generic" class=""> <header id="top"> <div class="container container--flex--wrap--mobile"> <a class="logo" href="https://www.djangoproject.com/">Django</a> The web framework for perfectionists with deadlines. <div class="mobile-toggle"> <button class="theme-toggle"> <div class="visually-hidden theme-label-when-auto">Toggle theme (current theme: auto)</div> <div class="visually-hidden theme-label-when-light">Toggle theme (current theme: light)</div> <div class="visually-hidden theme-label-when-dark">Toggle theme (current theme: dark)</div> <div class="visually-hidden">Toggle Light / Dark / Auto color theme</div> <svg aria-hidden="true" class="theme-icon-when-auto"> <use xlink:href="#icon-auto" /> </svg> <svg aria-hidden="true" class="theme-icon-when-dark"> <use xlink:href="#icon-moon" /> </svg> <svg aria-hidden="true" class="theme-icon-when-light"> <use xlink:href="#icon-sun" /> </svg> </button> </div> <button class="menu-button"> Menu </button> <nav aria-labelledby="navigation-header"> Main navigation <ul> <li class="active"> <a href="https://www.djangoproject.com/start/overview/">Overview</a> </li> <li> <a href="https://www.djangoproject.com/download/">Download</a> </li> <li> <a href="https://docs.djangoproject.com/">Documentation</a> </li> <li> <a href="https://www.djangoproject.com/weblog/">News</a> </li> <li> <a href="https://www.djangoproject.com/community/">Community</a> </li> <li> <a href="https://github.com/django/django" target="_blank" rel="noopener">Code</a> </li> <li> <a href="https://code.djangoproject.com/">Issues</a> </li> <li> <a href="https://www.djangoproject.com/foundation/">About</a> </li> <li> <a href="https://www.djangoproject.com/fundraising/">♥ Donate</a> </li> <li> <button class="theme-toggle"> <div class="visually-hidden theme-label-when-auto">Toggle theme (current theme: auto)</div> <div class="visually-hidden theme-label-when-light">Toggle theme (current theme: light)</div> <div class="visually-hidden theme-label-when-dark">Toggle theme (current theme: dark)</div> <div class="visually-hidden">Toggle Light / Dark / Auto color theme</div> <svg aria-hidden="true" class="theme-icon-when-auto"> <use xlink:href="#icon-auto" /> </svg> <svg aria-hidden="true" class="theme-icon-when-dark"> <use xlink:href="#icon-moon" /> </svg> <svg aria-hidden="true" class="theme-icon-when-light"> <use xlink:href="#icon-sun" /> </svg> </button> </li> </ul> </nav> </div> </header> <section class="copy-banner"> <div class="container "> <div class="layout-2col"> <div class="col two-third"> It’s quick & easy to get up and running with Django. </div> <div class="col one-third last-child"> <a href="https://www.djangoproject.com/download/" class="cta"> Download version 5.2 </a> </div> </div> </div> </section> <div id="billboard"></div> <div class="container full-width"> <main> <div class="section"> <h1>Getting started with Django</h1> Depending how new you are to Django, you can <a href="https://docs.djangoproject.com/en/stable/intro/tutorial01/">try a tutorial</a>, or just <a href="https://docs.djangoproject.com/">dive into the documentation</a>. Want to learn more about Django? Read the overview to see whether Django is right for your project. <a class="link-readmore" href="https://www.djangoproject.com/start/overview/">Django overview</a> </div> <div class="section"> <h2>Install Django</h2> Before you can use Django, you’ll need to install it. Our complete installation guide covers all the possibilities; this guide will get you to a simple, minimal installation that’ll work while you walk through the introduction. <a class="link-readmore" href="https://docs.djangoproject.com/en/stable/intro/install/"> Django installation guide </a> </div> <div class="section"> <h2>Write your first Django app</h2> Installed Django already? Good. Now <a href="https://docs.djangoproject.com/en/stable/intro/tutorial01/">try this tutorial</a>, which walks you through creating a basic poll application. It’s got two parts: <ol> <li>A public site that lets people view polls and vote in them.</li> <li>An administrative interface that lets you add, change and delete polls.</li> </ol> <a class="link-readmore" href="https://docs.djangoproject.com/en/stable/intro/tutorial01/">Take the tutorial</a> </div> <div class="section"> <h2>Sharpen your skills</h2> The official <a href="https://docs.djangoproject.com/">Django documentation</a> covers everything you need to know about Django (and then some). <a href="https://docs.djangoproject.com/" class="link-readmore">Read the docs</a> </div> <div class="section"> <h2>Join the community</h2> You can help <a href="https://www.djangoproject.com/community/">make us better</a>. Find out about upcoming Django events, learn what’s on other Django developers’ minds, find and post jobs, and more. <a href="https://www.djangoproject.com/community/" class="link-readmore">Join us</a> </div> <div class="list-collapsing-header"> <h2>Intro to Django</h2> </div> <ul class="list-collapsing"> <li> <h2>Object-relational mapper</h2> <div class="collapsing-content"> Deﬁne your data models entirely in Python. You get a rich, dynamic database-access API for free — but you can still write SQL if needed. <a class="link-readmore" href="https://docs.djangoproject.com/en/stable/topics/db/models/"> Read more </a> <div class="highlight"><pre>from django.db import models class Band(models.Model): """A model of a rock band.""" name = models.CharField(max_length=200) can_rock = models.BooleanField(default=True) class Member(models.Model): """A model of a rock band member.""" name = models.CharField("Member's name", max_length=200) instrument = models.CharField( choices=( ("g", "Guitar"), ("b", "Bass"), ("d", "Drums"), ), max_length=1, ) band = models.ForeignKey("Band") </pre></div> </div> </li> <li> <h2>URLs and views</h2> <div class="collapsing-content"> A clean, elegant URL scheme is an important detail in a high-quality web application. Django encourages beautiful URL design and doesn’t put any cruft in URLs, like .php or .asp. To design URLs for an application, you create a Python module called a URLconf. Like a table of contents for your app, it contains a simple mapping between URL patterns and your views. <a class="link-readmore" href="https://docs.djangoproject.com/en/stable/topics/http/urls/">Read more</a> <div class="highlight"><pre>from django.urls import path from . import views urlpatterns = [ path("bands/", views.band_listing, name="band-list"), path("bands/<int:band_id>/", views.band_detail, name="band-detail"), path("bands/search/", views.band_search, name="band-search"), ] </pre></div> <div class="highlight"><pre>from bands.models import Band from django.shortcuts import render def band_listing(request): """A view of all bands.""" bands = Band.objects.all() return render(request, "bands/band_listing.html", {"bands": bands}) </pre></div> </div> </li> <li> <h2>Templates</h2> <div class="collapsing-content"> Django’s template language is designed to strike a balance between power and ease. It’s designed to feel comfortable and easy-to-learn to those used to working with HTML, like designers and front-end developers. But it is also flexible and highly extensible, allowing developers to augment the template language as needed. <a class="link-readmore" href="https://docs.djangoproject.com/en/stable/topics/templates/">Read more</a> <div class="highlight"><pre><html> <head> <title>{% translate "Band Listing" %}</title> </head> <body> <h1>{% translate "All Bands" %}</h1> <ul> {% for band in bands %} <li> <h2><a href="{{ band.get_absolute_url }}">{{ band.name }}</a></h2> {% if band.can_rock %}{% translate "This band can rock!" %}{% endif %} </li> {% endfor %} </ul> </body> </html> </pre></div> </div> </li> <li> <h2>Forms</h2> <div class="collapsing-content"> Django provides a powerful form library that handles rendering forms as HTML, validating user-submitted data, and converting that data to native Python types. Django also provides a way to generate forms from your existing models and use those forms to create and update data. <a class="link-readmore" href="https://docs.djangoproject.com/en/stable/topics/forms/">Read more</a> <div class="highlight"><pre>from django import forms class BandContactForm(forms.Form): subject = forms.CharField(max_length=100) message = forms.TextField() sender = forms.EmailField() cc_myself = forms.BooleanField(required=False) </pre></div> </div> </li> <li> <h2>Authentication</h2> <div class="collapsing-content"> Django comes with a full-featured and secure authentication system. It handles user accounts, groups, permissions and cookie-based user sessions. This lets you easily build sites that allow users to create accounts and safely log in/out. <a class="link-readmore" href="https://docs.djangoproject.com/en/stable/topics/auth/">Read more</a> <div class="highlight"><pre>from django.contrib.auth.decorators import login_required from django.shortcuts import render @login_required def my_protected_view(request): """A view that can only be accessed by logged-in users""" return render(request, "protected.html", {"current_user": request.user}) </pre></div> </div> </li> <li> <h2>Admin</h2> <div class="collapsing-content"> One of the most powerful parts of Django is its automatic admin interface. It reads metadata in your models to provide a powerful and production-ready interface that content producers can immediately use to start managing content on your site. It’s easy to set up and provides many hooks for customization. <a class="link-readmore" href="https://docs.djangoproject.com/en/stable/ref/contrib/admin/">Read more</a> <div class="highlight"><pre>from bands.models import Band, Member from django.contrib import admin class MemberAdmin(admin.ModelAdmin): """Customize the look of the auto-generated admin for the Member model""" list_display = ("name", "instrument") list_filter = ("band",) admin.site.register(Band) # Use the default options admin.site.register(Member, MemberAdmin) # Use the customized options </pre></div> </div> </li> <li> <h2>Internationalization</h2> <div class="collapsing-content"> Django offers full support for translating text into different languages, plus locale-specific formatting of dates, times, numbers, and time zones. It lets developers and template authors specify which parts of their apps should be translated or formatted for local languages and cultures, and it uses these hooks to localize web applications for particular users according to their preferences. <a class="link-readmore" href="https://docs.djangoproject.com/en/stable/topics/i18n/">Read more</a> <div class="highlight"><pre>from django.shortcuts import render from django.utils.translation import gettext def homepage(request): """ Shows the homepage with a welcome message that is translated in the user's language. """ message = gettext("Welcome to our site!") return render(request, "homepage.html", {"message": message}) </pre></div> <div class="highlight"><pre>{% load i18n %} <html> <head> <title>{% translate "Homepage - Hall of Fame" %}</title> </head> <body> {# Translated in the view: #} <h1>{{ message }}</h1> {% blocktranslate count member_count=bands.count %} Here is the only band in the hall of fame: {% plural %} Here are all the {{ member_count }} bands in the hall of fame: {% endblocktranslate %} <ul> {% for band in bands %} <li> <h2><a href="{{ band.get_absolute_url }}">{{ band.name }}</a></h2> {% if band.can_rock %}{% translate 'This band can rock!' %}{% endif %} </li> {% endfor %} </ul> </body> </html> </pre></div> </div> </li> <li> <h2>Security</h2> <div class="collapsing-content"> Django provides multiple protections against: <ul> <li>Clickjacking</li> <li>Cross-site scripting</li> <li>Cross Site Request Forgery (CSRF)</li> <li>SQL injection</li> <li>Remote code execution</li> </ul> <a class="link-readmore" href="https://docs.djangoproject.com/en/stable/topics/security/">Read more</a> </div> </li> </ul> <a href="#top" class="backtotop"> Back to Top</a> </main> </div>  <svg xmlns="http://www.w3.org/2000/svg"> <symbol viewBox="0 0 24 24" id="icon-auto"><path d="M0 0h24v24H0z" fill="currentColor"/><path d="M12 22C6.477 22 2 17.523 2 12S6.477 2 12 2s10 4.477 10 10-4.477 10-10 10zm0-2V4a8 8 0 1 0 0 16z"/></symbol> <symbol viewBox="0 0 24 24" id="icon-moon"><path d="M0 0h24v24H0z" fill="currentColor"/><path d="M10 7a7 7 0 0 0 12 4.9v.1c0 5.523-4.477 10-10 10S2 17.523 2 12 6.477 2 12 2h.1A6.979 6.979 0 0 0 10 7zm-6 5a8 8 0 0 0 15.062 3.762A9 9 0 0 1 8.238 4.938 7.999 7.999 0 0 0 4 12z"/></symbol> <symbol viewBox="0 0 24 24" id="icon-sun"><path d="M0 0h24v24H0z" fill="currentColor"/><path d="M12 18a6 6 0 1 1 0-12 6 6 0 0 1 0 12zm0-2a4 4 0 1 0 0-8 4 4 0 0 0 0 8zM11 1h2v3h-2V1zm0 19h2v3h-2v-3zM3.515 4.929l1.414-1.414L7.05 5.636 5.636 7.05 3.515 4.93zM16.95 18.364l1.414-1.414 2.121 2.121-1.414 1.414-2.121-2.121zm2.121-14.85l1.414 1.415-2.121 2.121-1.414-1.414 2.121-2.121zM5.636 16.95l1.414 1.414-2.121 2.121-1.414-1.414 2.121-2.121zM23 11v2h-3v-2h3zM4 11v2H1v-2h3z"/></symbol> </svg>  <footer> <div class="subfooter"> <div class="container"> <h2 class="visuallyhidden">Django Links</h2> <div class="column-container"> <div class="col-learn-more"> <h3>Learn More</h3> <ul> <li><a href="https://www.djangoproject.com/start/overview/">About Django</a></li> <li><a href="https://www.djangoproject.com/start/">Getting Started with Django</a></li> <li><a href="https://docs.djangoproject.com/en/dev/internals/organization/">Team Organization</a></li> <li><a href="https://www.djangoproject.com/foundation/">Django Software Foundation</a></li> <li><a href="https://www.djangoproject.com/conduct/">Code of Conduct</a></li> <li><a href="https://www.djangoproject.com/diversity/">Diversity Statement</a></li> </ul> </div> <div class="col-get-involved"> <h3>Get Involved</h3> <ul> <li><a href="https://www.djangoproject.com/community/">Join a Group</a></li> <li><a href="https://docs.djangoproject.com/en/dev/internals/contributing/">Contribute to Django</a></li> <li><a href="https://docs.djangoproject.com/en/dev/internals/contributing/bugs-and-features/">Submit a Bug</a></li> <li><a href="https://docs.djangoproject.com/en/dev/internals/security/#reporting-security-issues">Report a Security Issue</a></li> <li><a href="https://www.djangoproject.com/foundation/individual-members/">Individual membership</a></li> </ul> </div> <div class="col-get-help"> <h3>Get Help</h3> <ul> <li><a href="https://docs.djangoproject.com/en/stable/faq/">Getting Help FAQ</a> </li> <li><a href="https://chat.djangoproject.com" target="_blank">Django Discord</a></li> <li><a href="https://forum.djangoproject.com/" target="_blank">Official Django Forum</a></li> </ul> </div> <div class="col-follow-us"> <h3>Follow Us</h3> <ul> <li><a href="https://github.com/django">GitHub</a></li> <li><a href="https://twitter.com/djangoproject">Twitter</a></li> <li><a href="https://fosstodon.org/@django" rel="me">Fediverse (Mastodon)</a></li> <li><a href="https://www.djangoproject.com/rss/weblog/">News RSS</a></li> </ul> </div> <div class="col-support-us"> <h3>Support Us</h3> <ul> <li><a href="https://www.djangoproject.com/fundraising/">Sponsor Django</a></li> <li><a href="/foundation/corporate-membership/">Corporate membership</a></li> <li><a href="https://django.threadless.com/" target="_blank">Official merchandise store</a></li> <li><a href="/foundation/donate/#benevity-giving">Benevity Workplace Giving Program</a></li> </ul> </div> </div> </div> </div> <div class="footer"> <div class="container"> <div class="footer-logo"> <a class="logo" href="https://www.djangoproject.com/">Django</a> </div> <ul class="thanks"> <li> Hosting by <a class="in-kind-donors" href="https://www.djangoproject.com/fundraising/#in-kind-donors">In-kind donors</a> </li> <li class="design">Design by <a class="threespot" href="https://www.threespot.com">Threespot</a> & <a class="andrevv" href="http://andrevv.com/">andrevv</a></li> </ul> © 2005-2025 <a href="https://www.djangoproject.com/foundation/"> Django Software Foundation</a> and individual contributors. Django is a <a href="https://www.djangoproject.com/trademarks/">registered trademark</a> of the Django Software Foundation. </div> </div> </footer> <script> function extless(input) { return input.replace(/(.*)\.[^.]+$/, '$1'); } var require = { shim: { 'jquery': [], 'jquery.flot': ["jquery"], 'stripe': { exports: 'Stripe' } }, paths: { "jquery": extless("https://static.djangoproject.com/js/lib/jquery.min.5790ead7ad3b.js"), "jquery.flot": extless("https://static.djangoproject.com/js/lib/jquery.flot.min.9964206e9d7f.js"), "mod/list-collapsing": extless("https://static.djangoproject.com/js/mod/list-collapsing.2d844151b2ec.js"), "mod/stripe-change-card": extless("https://static.djangoproject.com/js/mod/stripe-change-card.eaa0afc324e9.js"), "mod/switch-dark-mode": extless("https://static.djangoproject.com/js/mod/switch-dark-mode.bd4be131d69b.js"), "stripe-checkout": "https://checkout.stripe.com/checkout", "stripe": "https://js.stripe.com/v3/?" // ? needed due to require.js } }; </script> <script data-main="https://static.djangoproject.com/js/main.f422df460806.js" src="https://static.djangoproject.com/js/lib/require.177879fbe7dd.js"></script> <script src="https://static.djangoproject.com/js/djangoproject.f743688136c5.js"></script> </body> </html>

CINXE.COM

Getting started with Django | Django