CINXE.COM

<!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="canonical" href="https://docs.djangoproject.com/en/5.1/releases/5.0/"> <link rel="alternate" hreflang="el" href="https://docs.djangoproject.com/el/5.0/releases/5.0/"> <link rel="alternate" hreflang="en" href="https://docs.djangoproject.com/en/5.0/releases/5.0/"> <link rel="alternate" hreflang="es" href="https://docs.djangoproject.com/es/5.0/releases/5.0/"> <link rel="alternate" hreflang="fr" href="https://docs.djangoproject.com/fr/5.0/releases/5.0/"> <link rel="alternate" hreflang="id" href="https://docs.djangoproject.com/id/5.0/releases/5.0/"> <link rel="alternate" hreflang="it" href="https://docs.djangoproject.com/it/5.0/releases/5.0/"> <link rel="alternate" hreflang="ja" href="https://docs.djangoproject.com/ja/5.0/releases/5.0/"> <link rel="alternate" hreflang="ko" href="https://docs.djangoproject.com/ko/5.0/releases/5.0/"> <link rel="alternate" hreflang="pl" href="https://docs.djangoproject.com/pl/5.0/releases/5.0/"> <link rel="alternate" hreflang="pt-br" href="https://docs.djangoproject.com/pt-br/5.0/releases/5.0/"> <link rel="alternate" hreflang="zh-hans" href="https://docs.djangoproject.com/zh-hans/5.0/releases/5.0/"> <link rel="search" type="application/opensearchdescription+xml" href="https://docs.djangoproject.com/en/5.0/search/description/" title="Django documentation">  <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="Django 5.0 release notes | Django documentation" /> <meta property="og:description" content="The web framework for perfectionists with deadlines." /> <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://docs.djangoproject.com/en/5.0/releases/5.0/" /> <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>Django 5.0 release notes | Django documentation | Django</title> <link rel="stylesheet" href="https://static.djangoproject.com/css/output.fde294a46e8e.css" > <script src="https://static.djangoproject.com/js/lib/webfontloader/webfontloader.e75218f5f090.js"></script> <script> WebFont.load({ custom: { families: ['FontAwesome', 'Fira+Mono'], }, google: { families: ['Roboto:400italic,700italic,300,700,400:latin' ] }, classes: false, events: false, timeout: 1000 }); </script> <script src="https://static.djangoproject.com/js/lib/modernizr.3b36762e418a.js"></script> <script src="https://static.djangoproject.com/js/mod/switch-dark-mode.69777ee87b91.js"></script> </head> <body id="generic" class=""> <div role="banner" 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> <div role="navigation"> <ul> <li> <a href="https://www.djangoproject.com/start/overview/">Overview</a> </li> <li> <a href="https://www.djangoproject.com/download/">Download</a> </li> <li class="active"> <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> </div> </div> </div> <div class="copy-banner"> <div class="container container--flex container--flex--wrap--mobile "> <h1><a href="https://docs.djangoproject.com/en/5.0/">Documentation</a></h1> <form action="https://docs.djangoproject.com/en/5.0/search/" class="search form-input" role="search"> <label class="visuallyhidden" for="id_q">Search:</label> <input type="search" name="q" placeholder="Search 5.0 documentation" id="id_q"> <button type="submit"> Search </button> </form> </div> </div> <div id="billboard"></div> <div class="container sidebar-right"> <div role="main"> <div id="version-switcher"> <ul id="faq-link"> <li class="current-link"> <a href="https://docs.djangoproject.com/en/5.0/faq/help/"> Getting Help </a> </li> </ul> <ul id="doc-languages" class="language-switcher doc-switcher"> <li class="other"> <a href="https://docs.djangoproject.com/el/5.0/releases/5.0/">el</a> </li> <li class="other"> <a href="https://docs.djangoproject.com/es/5.0/releases/5.0/">es</a> </li> <li class="other"> <a href="https://docs.djangoproject.com/fr/5.0/releases/5.0/">fr</a> </li> <li class="other"> <a href="https://docs.djangoproject.com/id/5.0/releases/5.0/">id</a> </li> <li class="other"> <a href="https://docs.djangoproject.com/it/5.0/releases/5.0/">it</a> </li> <li class="other"> <a href="https://docs.djangoproject.com/ja/5.0/releases/5.0/">ja</a> </li> <li class="other"> <a href="https://docs.djangoproject.com/ko/5.0/releases/5.0/">ko</a> </li> <li class="other"> <a href="https://docs.djangoproject.com/pl/5.0/releases/5.0/">pl</a> </li> <li class="other"> <a href="https://docs.djangoproject.com/pt-br/5.0/releases/5.0/">pt-br</a> </li> <li class="other"> <a href="https://docs.djangoproject.com/zh-hans/5.0/releases/5.0/">zh-hans</a> </li> <li class="current" title="Click on the links on the left to switch to another language."> Language: en </li> </ul> <ul id="doc-versions" class="version-switcher doc-switcher"> <li class="other"> <a href="https://docs.djangoproject.com/en/5.1/releases/5.0/">5.1</a> </li> <li class="other"> <a href="https://docs.djangoproject.com/en/dev/releases/5.0/">dev</a> </li> <li class="current" title="This document describes Django 5.0. Click on the links on the left to see other versions."> Documentation version: 5.0 </li> </ul> <ul id="backtotop-link"> <li class="current-link"> <a href="#top" aria-label="Back to top" class="icon-chevron-up-align"></a> </li> </ul> </div> <div id="docs-content"> <div class="section" id="s-django-5-0-release-notes"> <h1>Django 5.0 release notes<a class="headerlink" href="#django-5-0-release-notes" title="Permalink to this headline">¶</a></h1> December 4, 2023 Welcome to Django 5.0! These release notes cover the <a class="reference internal" href="#whats-new-5-0">new features</a>, as well as some <a class="reference internal" href="#backwards-incompatible-5-0">backwards incompatible changes</a> you’ll want to be aware of when upgrading from Django 4.2 or earlier. We’ve <a class="reference internal" href="#deprecated-features-5-0">begun the deprecation process for some features</a>. See the <a class="reference internal" href="../../howto/upgrade-version/">How to upgrade Django to a newer version</a> guide if you’re updating an existing project. <div class="section" id="s-python-compatibility"> <h2>Python compatibility<a class="headerlink" href="#python-compatibility" title="Permalink to this headline">¶</a></h2> Django 5.0 supports Python 3.10, 3.11, and 3.12. We highly recommend and only officially support the latest release of each series. The Django 4.2.x series is the last to support Python 3.8 and 3.9. </div> <div class="section" id="s-third-party-library-support-for-older-version-of-django"> <h2>Third-party library support for older version of Django<a class="headerlink" href="#third-party-library-support-for-older-version-of-django" title="Permalink to this headline">¶</a></h2> Following the release of Django 5.0, we suggest that third-party app authors drop support for all versions of Django prior to 4.2. At that time, you should be able to run your package’s tests using <code class="docutils literal notranslate">python -Wd</code> so that deprecation warnings appear. After making the deprecation warning fixes, your app should be compatible with Django 5.0. </div> <div class="section" id="s-what-s-new-in-django-5-0"> <h2>What’s new in Django 5.0<a class="headerlink" href="#what-s-new-in-django-5-0" title="Permalink to this headline">¶</a></h2> <div class="section" id="s-facet-filters-in-the-admin"> <h3>Facet filters in the admin<a class="headerlink" href="#facet-filters-in-the-admin" title="Permalink to this headline">¶</a></h3> Facet counts are now shown for applied filters in the admin changelist when toggled on via the UI. This behavior can be changed via the new <a class="reference internal" href="../../ref/contrib/admin/#django.contrib.admin.ModelAdmin.show_facets" title="django.contrib.admin.ModelAdmin.show_facets"><code class="xref py py-attr docutils literal notranslate">ModelAdmin.show_facets</code></a> attribute. For more information see <a class="reference internal" href="../../ref/contrib/admin/filters/#facet-filters">Facets</a>. </div> <div class="section" id="s-simplified-templates-for-form-field-rendering"> <h3>Simplified templates for form field rendering<a class="headerlink" href="#simplified-templates-for-form-field-rendering" title="Permalink to this headline">¶</a></h3> Django 5.0 introduces the concept of a field group, and field group templates. This simplifies rendering of the related elements of a Django form field such as its label, widget, help text, and errors. For example, the template below: <div class="highlight-html+django notranslate"><div class="highlight"><pre><form> ... <div> {{ form.name.label_tag }} {% if form.name.help_text %} <div class="helptext" id="{{ form.name.auto_id }}_helptext"> {{ form.name.help_text|safe }} </div> {% endif %} {{ form.name.errors }} {{ form.name }} <div class="row"> <div class="col"> {{ form.email.label_tag }} {% if form.email.help_text %} <div class="helptext" id="{{ form.email.auto_id }}_helptext"> {{ form.email.help_text|safe }} </div> {% endif %} {{ form.email.errors }} {{ form.email }} </div> <div class="col"> {{ form.password.label_tag }} {% if form.password.help_text %} <div class="helptext" id="{{ form.password.auto_id }}_helptext"> {{ form.password.help_text|safe }} </div> {% endif %} {{ form.password.errors }} {{ form.password }} </div> </div> </div> ... </form> </pre></div> </div> Can now be simplified to: <div class="highlight-html+django notranslate"><div class="highlight"><pre><form> ... <div> {{ form.name.as_field_group }} <div class="row"> <div class="col">{{ form.email.as_field_group }}</div> <div class="col">{{ form.password.as_field_group }}</div> </div> </div> ... </form> </pre></div> </div> <a class="reference internal" href="../../ref/forms/api/#django.forms.BoundField.as_field_group" title="django.forms.BoundField.as_field_group"><code class="xref py py-meth docutils literal notranslate">as_field_group()</code></a> renders fields with the <code class="docutils literal notranslate">"django/forms/field.html"</code> template by default and can be customized on a per-project, per-field, or per-request basis. See <a class="reference internal" href="../../topics/forms/#reusable-field-group-templates">Reusable field group templates</a>. </div> <div class="section" id="s-database-computed-default-values"> <h3>Database-computed default values<a class="headerlink" href="#database-computed-default-values" title="Permalink to this headline">¶</a></h3> The new <a class="reference internal" href="../../ref/models/fields/#django.db.models.Field.db_default" title="django.db.models.Field.db_default"><code class="xref py py-attr docutils literal notranslate">Field.db_default</code></a> parameter sets a database-computed default value. For example: <div class="highlight-default notranslate"><div class="highlight"><pre>from django.db import models from django.db.models.functions import Now, Pi class MyModel(models.Model): age = models.IntegerField(db_default=18) created = models.DateTimeField(db_default=Now()) circumference = models.FloatField(db_default=2 * Pi()) </pre></div> </div> </div> <div class="section" id="s-database-generated-model-field"> <h3>Database generated model field<a class="headerlink" href="#database-generated-model-field" title="Permalink to this headline">¶</a></h3> The new <a class="reference internal" href="../../ref/models/fields/#django.db.models.GeneratedField" title="django.db.models.GeneratedField"><code class="xref py py-class docutils literal notranslate">GeneratedField</code></a> allows creation of database generated columns. This field can be used on all supported database backends to create a field that is always computed from other fields. For example: <div class="highlight-default notranslate"><div class="highlight"><pre>from django.db import models from django.db.models import F class Square(models.Model): side = models.IntegerField() area = models.GeneratedField( expression=F("side") * F("side"), output_field=models.BigIntegerField(), db_persist=True, ) </pre></div> </div> </div> <div class="section" id="s-more-options-for-declaring-field-choices"> <h3>More options for declaring field choices<a class="headerlink" href="#more-options-for-declaring-field-choices" title="Permalink to this headline">¶</a></h3> <a class="reference internal" href="../../ref/models/fields/#django.db.models.Field.choices" title="django.db.models.Field.choices"><code class="xref py py-attr docutils literal notranslate">Field.choices</code></a> (for model fields) and <a class="reference internal" href="../../ref/forms/fields/#django.forms.ChoiceField.choices" title="django.forms.ChoiceField.choices"><code class="xref py py-attr docutils literal notranslate">ChoiceField.choices</code></a> (for form fields) allow for more flexibility when declaring their values. In previous versions of Django, <code class="docutils literal notranslate">choices</code> should either be a list of 2-tuples, or an <a class="reference internal" href="../../ref/models/fields/#field-choices-enum-types">Enumeration types</a> subclass, but the latter required accessing the <code class="docutils literal notranslate">.choices</code> attribute to provide the values in the expected form: <div class="highlight-default notranslate"><div class="highlight"><pre>from django.db import models Medal = models.TextChoices("Medal", "GOLD SILVER BRONZE") SPORT_CHOICES = [ ("Martial Arts", [("judo", "Judo"), ("karate", "Karate")]), ("Racket", [("badminton", "Badminton"), ("tennis", "Tennis")]), ("unknown", "Unknown"), ] class Winner(models.Model): name = models.CharField(...) medal = models.CharField(..., choices=Medal.choices) sport = models.CharField(..., choices=SPORT_CHOICES) </pre></div> </div> Django 5.0 adds support for accepting a mapping or a callable instead of an iterable, and also no longer requires <code class="docutils literal notranslate">.choices</code> to be used directly to expand <a class="reference internal" href="../../ref/models/fields/#field-choices-enum-types">enumeration types</a>: <div class="highlight-default notranslate"><div class="highlight"><pre>from django.db import models Medal = models.TextChoices("Medal", "GOLD SILVER BRONZE") SPORT_CHOICES = { # Using a mapping instead of a list of 2-tuples. "Martial Arts": {"judo": "Judo", "karate": "Karate"}, "Racket": {"badminton": "Badminton", "tennis": "Tennis"}, "unknown": "Unknown", } def get_scores(): return [(i, str(i)) for i in range(10)] class Winner(models.Model): name = models.CharField(...) medal = models.CharField(..., choices=Medal) # Using `.choices` not required. sport = models.CharField(..., choices=SPORT_CHOICES) score = models.IntegerField(choices=get_scores) # A callable is allowed. </pre></div> </div> Under the hood the provided <code class="docutils literal notranslate">choices</code> are normalized into a list of 2-tuples as the canonical form whenever the <code class="docutils literal notranslate">choices</code> value is updated. For more information, please check the <a class="reference internal" href="../../ref/models/fields/#field-choices">model field reference on choices</a>. </div> <div class="section" id="s-minor-features"> <h3>Minor features<a class="headerlink" href="#minor-features" title="Permalink to this headline">¶</a></h3> <div class="section" id="s-django-contrib-admin"> <h4><a class="reference internal" href="../../ref/contrib/admin/#module-django.contrib.admin" title="django.contrib.admin: Django's admin site."><code class="xref py py-mod docutils literal notranslate">django.contrib.admin</code></a><a class="headerlink" href="#django-contrib-admin" title="Permalink to this headline">¶</a></h4> <ul class="simple"> <li>The new <a class="reference internal" href="../../ref/contrib/admin/#django.contrib.admin.AdminSite.get_log_entries" title="django.contrib.admin.AdminSite.get_log_entries"><code class="xref py py-meth docutils literal notranslate">AdminSite.get_log_entries()</code></a> method allows customizing the queryset for the site’s listed log entries.</li> <li>The <code class="docutils literal notranslate">django.contrib.admin.AllValuesFieldListFilter</code>, <code class="docutils literal notranslate">ChoicesFieldListFilter</code>, <code class="docutils literal notranslate">RelatedFieldListFilter</code>, and <code class="docutils literal notranslate">RelatedOnlyFieldListFilter</code> admin filters now handle multi-valued query parameters.</li> <li><code class="docutils literal notranslate">XRegExp</code> is upgraded from version 3.2.0 to 5.1.1.</li> <li>The new <a class="reference internal" href="../../ref/contrib/admin/#django.contrib.admin.AdminSite.get_model_admin" title="django.contrib.admin.AdminSite.get_model_admin"><code class="xref py py-meth docutils literal notranslate">AdminSite.get_model_admin()</code></a> method returns an admin class for the given model class.</li> <li>Properties in <a class="reference internal" href="../../ref/contrib/admin/#django.contrib.admin.ModelAdmin.list_display" title="django.contrib.admin.ModelAdmin.list_display"><code class="xref py py-attr docutils literal notranslate">ModelAdmin.list_display</code></a> now support <code class="docutils literal notranslate">boolean</code> attribute.</li> <li>jQuery is upgraded from version 3.6.4 to 3.7.1.</li> </ul> </div> <div class="section" id="s-django-contrib-auth"> <h4><a class="reference internal" href="../../topics/auth/#module-django.contrib.auth" title="django.contrib.auth: Django's authentication framework."><code class="xref py py-mod docutils literal notranslate">django.contrib.auth</code></a><a class="headerlink" href="#django-contrib-auth" title="Permalink to this headline">¶</a></h4> <ul class="simple"> <li>The default iteration count for the PBKDF2 password hasher is increased from 600,000 to 720,000.</li> <li>The new asynchronous functions are now provided, using an <code class="docutils literal notranslate">a</code> prefix: <a class="reference internal" href="../../topics/auth/default/#django.contrib.auth.aauthenticate" title="django.contrib.auth.aauthenticate"><code class="xref py py-func docutils literal notranslate">django.contrib.auth.aauthenticate()</code></a>, <a class="reference internal" href="../../ref/contrib/auth/#django.contrib.auth.aget_user" title="django.contrib.auth.aget_user"><code class="xref py py-func docutils literal notranslate">aget_user()</code></a>, <a class="reference internal" href="../../topics/auth/default/#django.contrib.auth.alogin" title="django.contrib.auth.alogin"><code class="xref py py-func docutils literal notranslate">alogin()</code></a>, <a class="reference internal" href="../../topics/auth/default/#django.contrib.auth.alogout" title="django.contrib.auth.alogout"><code class="xref py py-func docutils literal notranslate">alogout()</code></a>, and <a class="reference internal" href="../../topics/auth/default/#django.contrib.auth.aupdate_session_auth_hash" title="django.contrib.auth.aupdate_session_auth_hash"><code class="xref py py-func docutils literal notranslate">aupdate_session_auth_hash()</code></a>.</li> <li><code class="docutils literal notranslate">AuthenticationMiddleware</code> now adds an <a class="reference internal" href="../../ref/request-response/#django.http.HttpRequest.auser" title="django.http.HttpRequest.auser"><code class="xref py py-meth docutils literal notranslate">HttpRequest.auser()</code></a> asynchronous method that returns the currently logged-in user.</li> <li>The new <a class="reference internal" href="../../topics/auth/passwords/#django.contrib.auth.hashers.acheck_password" title="django.contrib.auth.hashers.acheck_password"><code class="xref py py-func docutils literal notranslate">django.contrib.auth.hashers.acheck_password()</code></a> asynchronous function and <a class="reference internal" href="../../topics/auth/customizing/#django.contrib.auth.models.AbstractBaseUser.acheck_password" title="django.contrib.auth.models.AbstractBaseUser.acheck_password"><code class="xref py py-meth docutils literal notranslate">AbstractBaseUser.acheck_password()</code></a> method allow asynchronous checking of user passwords.</li> </ul> </div> <div class="section" id="s-django-contrib-contenttypes"> <h4><a class="reference internal" href="../../ref/contrib/contenttypes/#module-django.contrib.contenttypes" title="django.contrib.contenttypes: Provides generic interface to installed models."><code class="xref py py-mod docutils literal notranslate">django.contrib.contenttypes</code></a><a class="headerlink" href="#django-contrib-contenttypes" title="Permalink to this headline">¶</a></h4> <ul class="simple"> <li><a class="reference internal" href="../../ref/models/querysets/#django.db.models.query.QuerySet.prefetch_related" title="django.db.models.query.QuerySet.prefetch_related"><code class="xref py py-meth docutils literal notranslate">QuerySet.prefetch_related()</code></a> now supports prefetching <a class="reference internal" href="../../ref/contrib/contenttypes/#django.contrib.contenttypes.fields.GenericForeignKey" title="django.contrib.contenttypes.fields.GenericForeignKey"><code class="xref py py-class docutils literal notranslate">GenericForeignKey</code></a> with non-homogeneous set of results.</li> </ul> </div> <div class="section" id="s-django-contrib-gis"> <h4><a class="reference internal" href="../../ref/contrib/gis/#module-django.contrib.gis" title="django.contrib.gis: Geographic Information System (GIS) extensions for Django"><code class="xref py py-mod docutils literal notranslate">django.contrib.gis</code></a><a class="headerlink" href="#django-contrib-gis" title="Permalink to this headline">¶</a></h4> <ul class="simple"> <li>The new <a class="reference internal" href="../../ref/contrib/gis/functions/#django.contrib.gis.db.models.functions.ClosestPoint" title="django.contrib.gis.db.models.functions.ClosestPoint"><code class="xref py py-class docutils literal notranslate">ClosestPoint()</code></a> function returns a 2-dimensional point on the geometry that is closest to another geometry.</li> <li><a class="reference internal" href="../../ref/contrib/gis/geoquerysets/#gis-aggregation-functions">GIS aggregates</a> now support the <code class="docutils literal notranslate">filter</code> argument.</li> <li>Support for GDAL 3.7 and GEOS 3.12 is added.</li> <li>The new <a class="reference internal" href="../../ref/contrib/gis/geos/#django.contrib.gis.geos.GEOSGeometry.equals_identical" title="django.contrib.gis.geos.GEOSGeometry.equals_identical"><code class="xref py py-meth docutils literal notranslate">GEOSGeometry.equals_identical()</code></a> method allows point-wise equivalence checking of geometries.</li> </ul> </div> <div class="section" id="s-django-contrib-messages"> <h4><a class="reference internal" href="../../ref/contrib/messages/#module-django.contrib.messages" title="django.contrib.messages: Provides cookie- and session-based temporary message storage."><code class="xref py py-mod docutils literal notranslate">django.contrib.messages</code></a><a class="headerlink" href="#django-contrib-messages" title="Permalink to this headline">¶</a></h4> <ul class="simple"> <li>The new <a class="reference internal" href="../../ref/contrib/messages/#django.contrib.messages.test.MessagesTestMixin.assertMessages" title="django.contrib.messages.test.MessagesTestMixin.assertMessages"><code class="xref py py-meth docutils literal notranslate">MessagesTestMixin.assertMessages()</code></a> assertion method allows testing <a class="reference internal" href="../../ref/contrib/messages/#module-django.contrib.messages" title="django.contrib.messages: Provides cookie- and session-based temporary message storage."><code class="xref py py-mod docutils literal notranslate">messages</code></a> added to a <a class="reference internal" href="../../ref/request-response/#django.http.HttpResponse" title="django.http.HttpResponse"><code class="xref py py-class docutils literal notranslate">response</code></a>.</li> </ul> </div> <div class="section" id="s-django-contrib-postgres"> <h4><a class="reference internal" href="../../ref/contrib/postgres/#module-django.contrib.postgres" title="django.contrib.postgres: PostgreSQL-specific fields and features"><code class="xref py py-mod docutils literal notranslate">django.contrib.postgres</code></a><a class="headerlink" href="#django-contrib-postgres" title="Permalink to this headline">¶</a></h4> <ul class="simple"> <li>The new <a class="reference internal" href="../../ref/contrib/postgres/constraints/#django.contrib.postgres.constraints.ExclusionConstraint.violation_error_code" title="django.contrib.postgres.constraints.ExclusionConstraint.violation_error_code"><code class="xref py py-attr docutils literal notranslate">violation_error_code</code></a> attribute of <a class="reference internal" href="../../ref/contrib/postgres/constraints/#django.contrib.postgres.constraints.ExclusionConstraint" title="django.contrib.postgres.constraints.ExclusionConstraint"><code class="xref py py-class docutils literal notranslate">ExclusionConstraint</code></a> allows customizing the <code class="docutils literal notranslate">code</code> of <code class="docutils literal notranslate">ValidationError</code> raised during <a class="reference internal" href="../../ref/models/instances/#validating-objects">model validation</a>.</li> </ul> </div> <div class="section" id="s-asynchronous-views"> <h4>Asynchronous views<a class="headerlink" href="#asynchronous-views" title="Permalink to this headline">¶</a></h4> <ul class="simple"> <li>Under ASGI, <code class="docutils literal notranslate">http.disconnect</code> events are now handled. This allows views to perform any necessary cleanup if a client disconnects before the response is generated. See <a class="reference internal" href="../../topics/async/#async-handling-disconnect">Handling disconnects</a> for more details.</li> </ul> </div> <div class="section" id="s-decorators"> <h4>Decorators<a class="headerlink" href="#decorators" title="Permalink to this headline">¶</a></h4> <ul class="simple"> <li>The following decorators now support wrapping asynchronous view functions:<ul> <li><a class="reference internal" href="../../topics/http/decorators/#django.views.decorators.cache.cache_control" title="django.views.decorators.cache.cache_control"><code class="xref py py-func docutils literal notranslate">cache_control()</code></a></li> <li><a class="reference internal" href="../../topics/http/decorators/#django.views.decorators.cache.never_cache" title="django.views.decorators.cache.never_cache"><code class="xref py py-func docutils literal notranslate">never_cache()</code></a></li> <li><a class="reference internal" href="../../topics/http/decorators/#django.views.decorators.common.no_append_slash" title="django.views.decorators.common.no_append_slash"><code class="xref py py-func docutils literal notranslate">no_append_slash()</code></a></li> <li><a class="reference internal" href="../../ref/csrf/#django.views.decorators.csrf.csrf_exempt" title="django.views.decorators.csrf.csrf_exempt"><code class="xref py py-func docutils literal notranslate">csrf_exempt()</code></a></li> <li><a class="reference internal" href="../../ref/csrf/#django.views.decorators.csrf.csrf_protect" title="django.views.decorators.csrf.csrf_protect"><code class="xref py py-func docutils literal notranslate">csrf_protect()</code></a></li> <li><a class="reference internal" href="../../ref/csrf/#django.views.decorators.csrf.ensure_csrf_cookie" title="django.views.decorators.csrf.ensure_csrf_cookie"><code class="xref py py-func docutils literal notranslate">ensure_csrf_cookie()</code></a></li> <li><a class="reference internal" href="../../ref/csrf/#django.views.decorators.csrf.requires_csrf_token" title="django.views.decorators.csrf.requires_csrf_token"><code class="xref py py-func docutils literal notranslate">requires_csrf_token()</code></a></li> <li><a class="reference internal" href="../../howto/error-reporting/#django.views.decorators.debug.sensitive_variables" title="django.views.decorators.debug.sensitive_variables"><code class="xref py py-func docutils literal notranslate">sensitive_variables()</code></a></li> <li><a class="reference internal" href="../../howto/error-reporting/#django.views.decorators.debug.sensitive_post_parameters" title="django.views.decorators.debug.sensitive_post_parameters"><code class="xref py py-func docutils literal notranslate">sensitive_post_parameters()</code></a></li> <li><a class="reference internal" href="../../topics/http/decorators/#django.views.decorators.gzip.gzip_page" title="django.views.decorators.gzip.gzip_page"><code class="xref py py-func docutils literal notranslate">gzip_page()</code></a></li> <li><a class="reference internal" href="../../topics/http/decorators/#django.views.decorators.http.condition" title="django.views.decorators.http.condition"><code class="xref py py-func docutils literal notranslate">condition()</code></a></li> <li><code class="docutils literal notranslate">conditional_page()</code></li> <li><a class="reference internal" href="../../topics/http/decorators/#django.views.decorators.http.etag" title="django.views.decorators.http.etag"><code class="xref py py-func docutils literal notranslate">etag()</code></a></li> <li><a class="reference internal" href="../../topics/http/decorators/#django.views.decorators.http.last_modified" title="django.views.decorators.http.last_modified"><code class="xref py py-func docutils literal notranslate">last_modified()</code></a></li> <li><a class="reference internal" href="../../topics/http/decorators/#django.views.decorators.http.require_http_methods" title="django.views.decorators.http.require_http_methods"><code class="xref py py-func docutils literal notranslate">require_http_methods()</code></a></li> <li><a class="reference internal" href="../../topics/http/decorators/#django.views.decorators.http.require_GET" title="django.views.decorators.http.require_GET"><code class="xref py py-func docutils literal notranslate">require_GET()</code></a></li> <li><a class="reference internal" href="../../topics/http/decorators/#django.views.decorators.http.require_POST" title="django.views.decorators.http.require_POST"><code class="xref py py-func docutils literal notranslate">require_POST()</code></a></li> <li><a class="reference internal" href="../../topics/http/decorators/#django.views.decorators.http.require_safe" title="django.views.decorators.http.require_safe"><code class="xref py py-func docutils literal notranslate">require_safe()</code></a></li> <li><a class="reference internal" href="../../topics/http/decorators/#django.views.decorators.vary.vary_on_cookie" title="django.views.decorators.vary.vary_on_cookie"><code class="xref py py-func docutils literal notranslate">vary_on_cookie()</code></a></li> <li><a class="reference internal" href="../../topics/http/decorators/#django.views.decorators.vary.vary_on_headers" title="django.views.decorators.vary.vary_on_headers"><code class="xref py py-func docutils literal notranslate">vary_on_headers()</code></a></li> <li><code class="docutils literal notranslate">xframe_options_deny()</code></li> <li><code class="docutils literal notranslate">xframe_options_sameorigin()</code></li> <li><code class="docutils literal notranslate">xframe_options_exempt()</code></li> </ul> </li> </ul> </div> <div class="section" id="s-error-reporting"> <h4>Error Reporting<a class="headerlink" href="#error-reporting" title="Permalink to this headline">¶</a></h4> <ul class="simple"> <li><a class="reference internal" href="../../howto/error-reporting/#django.views.decorators.debug.sensitive_variables" title="django.views.decorators.debug.sensitive_variables"><code class="xref py py-func docutils literal notranslate">sensitive_variables()</code></a> and <a class="reference internal" href="../../howto/error-reporting/#django.views.decorators.debug.sensitive_post_parameters" title="django.views.decorators.debug.sensitive_post_parameters"><code class="xref py py-func docutils literal notranslate">sensitive_post_parameters()</code></a> can now be used with asynchronous functions.</li> </ul> </div> <div class="section" id="s-file-storage"> <h4>File Storage<a class="headerlink" href="#file-storage" title="Permalink to this headline">¶</a></h4> <ul class="simple"> <li><a class="reference internal" href="../../ref/files/file/#django.core.files.File.open" title="django.core.files.File.open"><code class="xref py py-meth docutils literal notranslate">File.open()</code></a> now passes all positional (<code class="docutils literal notranslate">*args</code>) and keyword arguments (<code class="docutils literal notranslate">**kwargs</code>) to Python’s built-in <a class="reference external" href="https://docs.python.org/3/library/functions.html#open" title="(in Python v3.12)"><code class="docutils literal notranslate">open()</code></a>.</li> </ul> </div> <div class="section" id="s-forms"> <h4>Forms<a class="headerlink" href="#forms" title="Permalink to this headline">¶</a></h4> <ul class="simple"> <li>The new <a class="reference internal" href="../../ref/forms/fields/#django.forms.URLField.assume_scheme" title="django.forms.URLField.assume_scheme"><code class="xref py py-attr docutils literal notranslate">assume_scheme</code></a> argument for <a class="reference internal" href="../../ref/forms/fields/#django.forms.URLField" title="django.forms.URLField"><code class="xref py py-class docutils literal notranslate">URLField</code></a> allows specifying a default URL scheme.</li> <li>In order to improve accessibility, the following changes are made:<ul> <li>Form fields now include the <code class="docutils literal notranslate">aria-describedby</code> HTML attribute to enable screen readers to associate form fields with their help text.</li> <li>Invalid form fields now include the <code class="docutils literal notranslate">aria-invalid="true"</code> HTML attribute.</li> </ul> </li> </ul> </div> <div class="section" id="s-internationalization"> <h4>Internationalization<a class="headerlink" href="#internationalization" title="Permalink to this headline">¶</a></h4> <ul class="simple"> <li>Support and translations for the Uyghur language are now available.</li> </ul> </div> <div class="section" id="s-migrations"> <h4>Migrations<a class="headerlink" href="#migrations" title="Permalink to this headline">¶</a></h4> <ul class="simple"> <li>Serialization of functions decorated with <a class="reference external" href="https://docs.python.org/3/library/functools.html#functools.cache" title="(in Python v3.12)"><code class="xref py py-func docutils literal notranslate">functools.cache()</code></a> or <a class="reference external" href="https://docs.python.org/3/library/functools.html#functools.lru_cache" title="(in Python v3.12)"><code class="xref py py-func docutils literal notranslate">functools.lru_cache()</code></a> is now supported without the need to write a custom serializer.</li> </ul> </div> <div class="section" id="s-models"> <h4>Models<a class="headerlink" href="#models" title="Permalink to this headline">¶</a></h4> <ul class="simple"> <li>The new <code class="docutils literal notranslate">create_defaults</code> argument of <a class="reference internal" href="../../ref/models/querysets/#django.db.models.query.QuerySet.update_or_create" title="django.db.models.query.QuerySet.update_or_create"><code class="xref py py-meth docutils literal notranslate">QuerySet.update_or_create()</code></a> and <a class="reference internal" href="../../ref/models/querysets/#django.db.models.query.QuerySet.aupdate_or_create" title="django.db.models.query.QuerySet.aupdate_or_create"><code class="xref py py-meth docutils literal notranslate">QuerySet.aupdate_or_create()</code></a> methods allows specifying a different field values for the create operation.</li> <li>The new <code class="docutils literal notranslate">violation_error_code</code> attribute of <a class="reference internal" href="../../ref/models/constraints/#django.db.models.BaseConstraint" title="django.db.models.BaseConstraint"><code class="xref py py-class docutils literal notranslate">BaseConstraint</code></a>, <a class="reference internal" href="../../ref/models/constraints/#django.db.models.CheckConstraint" title="django.db.models.CheckConstraint"><code class="xref py py-class docutils literal notranslate">CheckConstraint</code></a>, and <a class="reference internal" href="../../ref/models/constraints/#django.db.models.UniqueConstraint" title="django.db.models.UniqueConstraint"><code class="xref py py-class docutils literal notranslate">UniqueConstraint</code></a> allows customizing the <code class="docutils literal notranslate">code</code> of <code class="docutils literal notranslate">ValidationError</code> raised during <a class="reference internal" href="../../ref/models/instances/#validating-objects">model validation</a>.</li> <li>The <a class="reference internal" href="../../ref/models/instances/#ref-models-force-insert">force_insert</a> argument of <a class="reference internal" href="../../ref/models/instances/#django.db.models.Model.save" title="django.db.models.Model.save"><code class="xref py py-meth docutils literal notranslate">Model.save()</code></a> now allows specifying a tuple of parent classes that must be forced to be inserted.</li> <li><a class="reference internal" href="../../ref/models/querysets/#django.db.models.query.QuerySet.bulk_create" title="django.db.models.query.QuerySet.bulk_create"><code class="xref py py-meth docutils literal notranslate">QuerySet.bulk_create()</code></a> and <a class="reference internal" href="../../ref/models/querysets/#django.db.models.query.QuerySet.abulk_create" title="django.db.models.query.QuerySet.abulk_create"><code class="xref py py-meth docutils literal notranslate">QuerySet.abulk_create()</code></a> methods now set the primary key on each model instance when the <code class="docutils literal notranslate">update_conflicts</code> parameter is enabled (if the database supports it).</li> <li>The new <a class="reference internal" href="../../ref/models/constraints/#django.db.models.UniqueConstraint.nulls_distinct" title="django.db.models.UniqueConstraint.nulls_distinct"><code class="xref py py-attr docutils literal notranslate">UniqueConstraint.nulls_distinct</code></a> attribute allows customizing the treatment of <code class="docutils literal notranslate">NULL</code> values on PostgreSQL 15+.</li> <li>The new <a class="reference internal" href="../../topics/http/shortcuts/#django.shortcuts.aget_object_or_404" title="django.shortcuts.aget_object_or_404"><code class="xref py py-func docutils literal notranslate">aget_object_or_404()</code></a> and <a class="reference internal" href="../../topics/http/shortcuts/#django.shortcuts.aget_list_or_404" title="django.shortcuts.aget_list_or_404"><code class="xref py py-func docutils literal notranslate">aget_list_or_404()</code></a> asynchronous shortcuts allow asynchronous getting objects.</li> <li>The new <a class="reference internal" href="../../ref/models/querysets/#django.db.models.aprefetch_related_objects" title="django.db.models.aprefetch_related_objects"><code class="xref py py-func docutils literal notranslate">aprefetch_related_objects()</code></a> function allows asynchronous prefetching of model instances.</li> <li><a class="reference internal" href="../../ref/models/querysets/#django.db.models.query.QuerySet.aiterator" title="django.db.models.query.QuerySet.aiterator"><code class="xref py py-meth docutils literal notranslate">QuerySet.aiterator()</code></a> now supports previous calls to <code class="docutils literal notranslate">prefetch_related()</code>.</li> <li>On MariaDB 10.7+, <code class="docutils literal notranslate">UUIDField</code> is now created as <code class="docutils literal notranslate">UUID</code> column rather than <code class="docutils literal notranslate">CHAR(32)</code> column. See the migration guide above for more details on <a class="reference internal" href="#migrating-uuidfield">Migrating existing UUIDField on MariaDB 10.7+</a>.</li> <li>Django now supports <a class="reference external" href="https://oracle.github.io/python-oracledb/">oracledb</a> version 1.3.2 or higher. Support for <code class="docutils literal notranslate">cx_Oracle</code> is deprecated as of this release and will be removed in Django 6.0.</li> </ul> </div> <div class="section" id="s-pagination"> <h4>Pagination<a class="headerlink" href="#pagination" title="Permalink to this headline">¶</a></h4> <ul class="simple"> <li>The new <a class="reference internal" href="../../ref/paginator/#django.core.paginator.Paginator.error_messages" title="django.core.paginator.Paginator.error_messages"><code class="xref py py-attr docutils literal notranslate">django.core.paginator.Paginator.error_messages</code></a> argument allows customizing the error messages raised by <a class="reference internal" href="../../ref/paginator/#django.core.paginator.Paginator.page" title="django.core.paginator.Paginator.page"><code class="xref py py-meth docutils literal notranslate">Paginator.page()</code></a>.</li> </ul> </div> <div class="section" id="s-signals"> <h4>Signals<a class="headerlink" href="#signals" title="Permalink to this headline">¶</a></h4> <ul class="simple"> <li>The new <a class="reference internal" href="../../topics/signals/#django.dispatch.Signal.asend" title="django.dispatch.Signal.asend"><code class="xref py py-meth docutils literal notranslate">Signal.asend()</code></a> and <a class="reference internal" href="../../topics/signals/#django.dispatch.Signal.asend_robust" title="django.dispatch.Signal.asend_robust"><code class="xref py py-meth docutils literal notranslate">Signal.asend_robust()</code></a> methods allow asynchronous signal dispatch. Signal receivers may be synchronous or asynchronous, and will be automatically adapted to the correct calling style.</li> </ul> </div> <div class="section" id="s-templates"> <h4>Templates<a class="headerlink" href="#templates" title="Permalink to this headline">¶</a></h4> <ul class="simple"> <li>The new <a class="reference internal" href="../../ref/templates/builtins/#std-templatefilter-escapeseq"><code class="xref std std-tfilter docutils literal notranslate">escapeseq</code></a> template filter applies <a class="reference internal" href="../../ref/templates/builtins/#std-templatefilter-escape"><code class="xref std std-tfilter docutils literal notranslate">escape</code></a> to each element of a sequence.</li> </ul> </div> <div class="section" id="s-tests"> <h4>Tests<a class="headerlink" href="#tests" title="Permalink to this headline">¶</a></h4> <ul class="simple"> <li><a class="reference internal" href="../../topics/testing/tools/#django.test.Client" title="django.test.Client"><code class="xref py py-class docutils literal notranslate">Client</code></a> and <a class="reference internal" href="../../topics/testing/tools/#django.test.AsyncClient" title="django.test.AsyncClient"><code class="xref py py-class docutils literal notranslate">AsyncClient</code></a> now provide asynchronous methods, using an <code class="docutils literal notranslate">a</code> prefix: <a class="reference internal" href="../../topics/testing/tools/#django.test.Client.asession" title="django.test.Client.asession"><code class="xref py py-meth docutils literal notranslate">asession()</code></a>, <a class="reference internal" href="../../topics/testing/tools/#django.test.Client.alogin" title="django.test.Client.alogin"><code class="xref py py-meth docutils literal notranslate">alogin()</code></a>, <a class="reference internal" href="../../topics/testing/tools/#django.test.Client.aforce_login" title="django.test.Client.aforce_login"><code class="xref py py-meth docutils literal notranslate">aforce_login()</code></a>, and <a class="reference internal" href="../../topics/testing/tools/#django.test.Client.alogout" title="django.test.Client.alogout"><code class="xref py py-meth docutils literal notranslate">alogout()</code></a>.</li> <li><a class="reference internal" href="../../topics/testing/tools/#django.test.AsyncClient" title="django.test.AsyncClient"><code class="xref py py-class docutils literal notranslate">AsyncClient</code></a> now supports the <code class="docutils literal notranslate">follow</code> parameter.</li> <li>The new <a class="reference internal" href="../../ref/django-admin/#cmdoption-test-durations"><code class="xref std std-option docutils literal notranslate">test --durations</code></a> option allows showing the duration of the slowest tests on Python 3.12+.</li> </ul> </div> <div class="section" id="s-validators"> <h4>Validators<a class="headerlink" href="#validators" title="Permalink to this headline">¶</a></h4> <ul class="simple"> <li>The new <code class="docutils literal notranslate">offset</code> argument of <a class="reference internal" href="../../ref/validators/#django.core.validators.StepValueValidator" title="django.core.validators.StepValueValidator"><code class="xref py py-class docutils literal notranslate">StepValueValidator</code></a> allows specifying an offset for valid values.</li> </ul> </div> </div> </div> <div class="section" id="s-backwards-incompatible-changes-in-5-0"> <h2>Backwards incompatible changes in 5.0<a class="headerlink" href="#backwards-incompatible-changes-in-5-0" title="Permalink to this headline">¶</a></h2> <div class="section" id="s-database-backend-api"> <h3>Database backend API<a class="headerlink" href="#database-backend-api" title="Permalink to this headline">¶</a></h3> This section describes changes that may be needed in third-party database backends. <ul class="simple"> <li><code class="docutils literal notranslate">DatabaseFeatures.supports_expression_defaults</code> should be set to <code class="docutils literal notranslate">False</code> if the database doesn’t support using database functions as defaults.</li> <li><code class="docutils literal notranslate">DatabaseFeatures.supports_default_keyword_in_insert</code> should be set to <code class="docutils literal notranslate">False</code> if the database doesn’t support the <code class="docutils literal notranslate">DEFAULT</code> keyword in <code class="docutils literal notranslate">INSERT</code> queries.</li> <li><code class="docutils literal notranslate">DatabaseFeatures.supports_default_keyword_in_bulk_insert</code> should be set to <code class="docutils literal notranslate">False</code> if the database doesn’t support the <code class="docutils literal notranslate">DEFAULT</code> keyword in bulk <code class="docutils literal notranslate">INSERT</code> queries.</li> </ul> </div> <div class="section" id="s-id1"> <h3><a class="reference internal" href="../../ref/contrib/gis/#module-django.contrib.gis" title="django.contrib.gis: Geographic Information System (GIS) extensions for Django"><code class="xref py py-mod docutils literal notranslate">django.contrib.gis</code></a><a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h3> <ul class="simple"> <li>Support for GDAL 2.2 and 2.3 is removed.</li> <li>Support for GEOS 3.6 and 3.7 is removed.</li> </ul> </div> <div class="section" id="s-django-contrib-sitemaps"> <h3><a class="reference internal" href="../../ref/contrib/sitemaps/#module-django.contrib.sitemaps" title="django.contrib.sitemaps: A framework for generating Google sitemap XML files."><code class="xref py py-mod docutils literal notranslate">django.contrib.sitemaps</code></a><a class="headerlink" href="#django-contrib-sitemaps" title="Permalink to this headline">¶</a></h3> <ul class="simple"> <li>The <code class="docutils literal notranslate">django.contrib.sitemaps.ping_google()</code> function and the <code class="docutils literal notranslate">ping_google</code> management command are removed as the Google Sitemaps ping endpoint is deprecated and will be removed in January 2024.</li> <li>The <code class="docutils literal notranslate">django.contrib.sitemaps.SitemapNotFound</code> exception class is removed.</li> </ul> </div> <div class="section" id="s-dropped-support-for-mysql-8-0-11"> <h3>Dropped support for MySQL < 8.0.11<a class="headerlink" href="#dropped-support-for-mysql-8-0-11" title="Permalink to this headline">¶</a></h3> Support for pre-releases of MySQL 8.0.x series is removed. Django 5.0 supports MySQL 8.0.11 and higher. </div> <div class="section" id="s-using-create-defaults-exact-may-now-be-required-with-queryset-update-or-create"> <h3>Using <code class="docutils literal notranslate">create_defaults__exact</code> may now be required with <code class="docutils literal notranslate">QuerySet.update_or_create()</code><a class="headerlink" href="#using-create-defaults-exact-may-now-be-required-with-queryset-update-or-create" title="Permalink to this headline">¶</a></h3> <a class="reference internal" href="../../ref/models/querysets/#django.db.models.query.QuerySet.update_or_create" title="django.db.models.query.QuerySet.update_or_create"><code class="xref py py-meth docutils literal notranslate">QuerySet.update_or_create()</code></a> now supports the parameter <code class="docutils literal notranslate">create_defaults</code>. As a consequence, any models that have a field named <code class="docutils literal notranslate">create_defaults</code> that are used with an <code class="docutils literal notranslate">update_or_create()</code> should specify the field in the lookup with <code class="docutils literal notranslate">create_defaults__exact</code>. </div> <div class="section" id="s-migrating-existing-uuidfield-on-mariadb-10-7"> <h3>Migrating existing <code class="docutils literal notranslate">UUIDField</code> on MariaDB 10.7+<a class="headerlink" href="#migrating-existing-uuidfield-on-mariadb-10-7" title="Permalink to this headline">¶</a></h3> On MariaDB 10.7+, <code class="docutils literal notranslate">UUIDField</code> is now created as <code class="docutils literal notranslate">UUID</code> column rather than <code class="docutils literal notranslate">CHAR(32)</code> column. As a consequence, any <code class="docutils literal notranslate">UUIDField</code> created in Django < 5.0 should be replaced with a <code class="docutils literal notranslate">UUIDField</code> subclass backed by <code class="docutils literal notranslate">CHAR(32)</code>: <div class="highlight-default notranslate"><div class="highlight"><pre>class Char32UUIDField(models.UUIDField): def db_type(self, connection): return "char(32)" def get_db_prep_value(self, value, connection, prepared=False): value = super().get_db_prep_value(value, connection, prepared) if value is not None: value = value.hex return value </pre></div> </div> For example: <div class="highlight-default notranslate"><div class="highlight"><pre>class MyModel(models.Model): uuid = models.UUIDField(primary_key=True, default=uuid.uuid4) </pre></div> </div> Should become: <div class="highlight-default notranslate"><div class="highlight"><pre>class Char32UUIDField(models.UUIDField): ... class MyModel(models.Model): uuid = Char32UUIDField(primary_key=True, default=uuid.uuid4) </pre></div> </div> Running the <a class="reference internal" href="../../ref/django-admin/#django-admin-makemigrations"><code class="xref std std-djadmin docutils literal notranslate">makemigrations</code></a> command will generate a migration containing a no-op <code class="docutils literal notranslate">AlterField</code> operation. </div> <div class="section" id="s-miscellaneous"> <h3>Miscellaneous<a class="headerlink" href="#miscellaneous" title="Permalink to this headline">¶</a></h3> <ul class="simple"> <li>The <code class="docutils literal notranslate">instance</code> argument of the undocumented <code class="docutils literal notranslate">BaseModelFormSet.save_existing()</code> method is renamed to <code class="docutils literal notranslate">obj</code>.</li> <li>The undocumented <code class="docutils literal notranslate">django.contrib.admin.helpers.checkbox</code> is removed.</li> <li>Integer fields are now validated as 64-bit integers on SQLite to match the behavior of <code class="docutils literal notranslate">sqlite3</code>.</li> <li>The undocumented <code class="docutils literal notranslate">Query.annotation_select_mask</code> attribute is changed from a set of strings to an ordered list of strings.</li> <li><code class="docutils literal notranslate">ImageField.update_dimension_fields()</code> is no longer called on the <code class="docutils literal notranslate">post_init</code> signal if <code class="docutils literal notranslate">width_field</code> and <code class="docutils literal notranslate">height_field</code> are not set.</li> <li><a class="reference internal" href="../../ref/models/database-functions/#django.db.models.functions.Now" title="django.db.models.functions.Now"><code class="xref py py-class docutils literal notranslate">Now</code></a> database function now uses <code class="docutils literal notranslate">LOCALTIMESTAMP</code> instead of <code class="docutils literal notranslate">CURRENT_TIMESTAMP</code> on Oracle.</li> <li><a class="reference internal" href="../../ref/contrib/admin/#django.contrib.admin.AdminSite.site_header" title="django.contrib.admin.AdminSite.site_header"><code class="xref py py-attr docutils literal notranslate">AdminSite.site_header</code></a> is now rendered in a <code class="docutils literal notranslate"><div></code> tag instead of <code class="docutils literal notranslate"><h1></code>. Screen reader users rely on heading elements for navigation within a page. Having two <code class="docutils literal notranslate"><h1></code> elements was confusing and the site header wasn’t helpful as it is repeated on all pages.</li> <li>In order to improve accessibility, the admin’s main content area and header content area are now rendered in a <code class="docutils literal notranslate"><main></code> and <code class="docutils literal notranslate"><header></code> tag instead of <code class="docutils literal notranslate"><div></code>.</li> <li>On databases without native support for the SQL <code class="docutils literal notranslate">XOR</code> operator, <code class="docutils literal notranslate">^</code> as the exclusive or (<code class="docutils literal notranslate">XOR</code>) operator now returns rows that are matched by an odd number of operands rather than exactly one operand. This is consistent with the behavior of MySQL, MariaDB, and Python.</li> <li>The minimum supported version of <code class="docutils literal notranslate">asgiref</code> is increased from 3.6.0 to 3.7.0.</li> <li>The minimum supported version of <code class="docutils literal notranslate">selenium</code> is increased from 3.8.0 to 4.8.0.</li> <li>The <code class="docutils literal notranslate">AlreadyRegistered</code> and <code class="docutils literal notranslate">NotRegistered</code> exceptions are moved from <code class="docutils literal notranslate">django.contrib.admin.sites</code> to <code class="docutils literal notranslate">django.contrib.admin.exceptions</code>.</li> <li>The minimum supported version of SQLite is increased from 3.21.0 to 3.27.0.</li> <li>Support for <code class="docutils literal notranslate">cx_Oracle</code> < 8.3 is removed.</li> <li>Executing SQL queries before the app registry has been fully populated now raises <a class="reference external" href="https://docs.python.org/3/library/exceptions.html#RuntimeWarning" title="(in Python v3.12)"><code class="xref py py-exc docutils literal notranslate">RuntimeWarning</code></a>.</li> <li><a class="reference internal" href="../../ref/exceptions/#django.core.exceptions.BadRequest" title="django.core.exceptions.BadRequest"><code class="xref py py-exc docutils literal notranslate">BadRequest</code></a> is raised for non-UTF-8 encoded requests with the application/x-www-form-urlencoded content type. See <a class="rfc reference external" href="https://datatracker.ietf.org/doc/html/rfc1866.html">RFC 1866</a> for more details.</li> <li>The minimum supported version of <code class="docutils literal notranslate">colorama</code> is increased to 0.4.6.</li> <li>The minimum supported version of <code class="docutils literal notranslate">docutils</code> is increased to 0.19.</li> <li>Filtering querysets against overflowing integer values now always returns an empty queryset. As a consequence, you may need to use <code class="docutils literal notranslate">ExpressionWrapper()</code> to <a class="reference internal" href="../../ref/models/expressions/#using-f-with-annotations">explicitly wrap</a> arithmetic against integer fields in such cases.</li> </ul> </div> </div> <div class="section" id="s-features-deprecated-in-5-0"> <h2>Features deprecated in 5.0<a class="headerlink" href="#features-deprecated-in-5-0" title="Permalink to this headline">¶</a></h2> <div class="section" id="s-id2"> <h3>Miscellaneous<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h3> <ul class="simple"> <li>The <code class="docutils literal notranslate">DjangoDivFormRenderer</code> and <code class="docutils literal notranslate">Jinja2DivFormRenderer</code> transitional form renderers are deprecated.</li> <li>Passing positional arguments <code class="docutils literal notranslate">name</code> and <code class="docutils literal notranslate">violation_error_message</code> to <a class="reference internal" href="../../ref/models/constraints/#django.db.models.BaseConstraint" title="django.db.models.BaseConstraint"><code class="xref py py-class docutils literal notranslate">BaseConstraint</code></a> is deprecated in favor of keyword-only arguments.</li> <li><code class="docutils literal notranslate">request</code> is added to the signature of <a class="reference internal" href="../../ref/contrib/admin/#django.contrib.admin.ModelAdmin.lookup_allowed" title="django.contrib.admin.ModelAdmin.lookup_allowed"><code class="xref py py-meth docutils literal notranslate">ModelAdmin.lookup_allowed()</code></a>. Support for <code class="docutils literal notranslate">ModelAdmin</code> subclasses that do not accept this argument is deprecated.</li> <li>The <code class="docutils literal notranslate">get_joining_columns()</code> method of <code class="docutils literal notranslate">ForeignObject</code> and <code class="docutils literal notranslate">ForeignObjectRel</code> is deprecated. Starting with Django 6.0, <code class="docutils literal notranslate">django.db.models.sql.datastructures.Join</code> will no longer fallback to <code class="docutils literal notranslate">get_joining_columns()</code>. Subclasses should implement <code class="docutils literal notranslate">get_joining_fields()</code> instead.</li> <li>The <code class="docutils literal notranslate">ForeignObject.get_reverse_joining_columns()</code> method is deprecated.</li> <li>The default scheme for <code class="docutils literal notranslate">forms.URLField</code> will change from <code class="docutils literal notranslate">"http"</code> to <code class="docutils literal notranslate">"https"</code> in Django 6.0. Set <a class="reference internal" href="../../ref/settings/#std-setting-FORMS_URLFIELD_ASSUME_HTTPS"><code class="xref std std-setting docutils literal notranslate">FORMS_URLFIELD_ASSUME_HTTPS</code></a> transitional setting to <code class="docutils literal notranslate">True</code> to opt into assuming <code class="docutils literal notranslate">"https"</code> during the Django 5.x release cycle.</li> <li><code class="docutils literal notranslate">FORMS_URLFIELD_ASSUME_HTTPS</code> transitional setting is deprecated.</li> <li>Support for calling <code class="docutils literal notranslate">format_html()</code> without passing args or kwargs will be removed.</li> <li>Support for <code class="docutils literal notranslate">cx_Oracle</code> is deprecated in favor of <a class="reference external" href="https://oracle.github.io/python-oracledb/">oracledb</a> 1.3.2+ Python driver.</li> <li><code class="docutils literal notranslate">DatabaseOperations.field_cast_sql()</code> is deprecated in favor of <code class="docutils literal notranslate">DatabaseOperations.lookup_cast()</code>. Starting with Django 6.0, <code class="docutils literal notranslate">BuiltinLookup.process_lhs()</code> will no longer call <code class="docutils literal notranslate">field_cast_sql()</code>. Third-party database backends should implement <code class="docutils literal notranslate">lookup_cast()</code> instead.</li> <li>The <code class="docutils literal notranslate">django.db.models.enums.ChoicesMeta</code> metaclass is renamed to <code class="docutils literal notranslate">ChoicesType</code>.</li> <li>The <code class="docutils literal notranslate">Prefetch.get_current_queryset()</code> method is deprecated.</li> <li>The <code class="docutils literal notranslate">get_prefetch_queryset()</code> method of related managers and descriptors is deprecated. Starting with Django 6.0, <code class="docutils literal notranslate">get_prefetcher()</code> and <code class="docutils literal notranslate">prefetch_related_objects()</code> will no longer fallback to <code class="docutils literal notranslate">get_prefetch_queryset()</code>. Subclasses should implement <code class="docutils literal notranslate">get_prefetch_querysets()</code> instead.</li> </ul> </div> </div> <div class="section" id="s-features-removed-in-5-0"> <h2>Features removed in 5.0<a class="headerlink" href="#features-removed-in-5-0" title="Permalink to this headline">¶</a></h2> These features have reached the end of their deprecation cycle and are removed in Django 5.0. See <a class="reference internal" href="../4.0/#deprecated-features-4-0">Features deprecated in 4.0</a> for details on these changes, including how to remove usage of these features. <ul class="simple"> <li>The <code class="docutils literal notranslate">SERIALIZE</code> test setting is removed.</li> <li>The undocumented <code class="docutils literal notranslate">django.utils.baseconv</code> module is removed.</li> <li>The undocumented <code class="docutils literal notranslate">django.utils.datetime_safe</code> module is removed.</li> <li>The default value of the <code class="docutils literal notranslate">USE_TZ</code> setting is changed from <code class="docutils literal notranslate">False</code> to <code class="docutils literal notranslate">True</code>.</li> <li>The default sitemap protocol for sitemaps built outside the context of a request is changed from <code class="docutils literal notranslate">'http'</code> to <code class="docutils literal notranslate">'https'</code>.</li> <li>The <code class="docutils literal notranslate">extra_tests</code> argument for <code class="docutils literal notranslate">DiscoverRunner.build_suite()</code> and <code class="docutils literal notranslate">DiscoverRunner.run_tests()</code> is removed.</li> <li>The <code class="docutils literal notranslate">django.contrib.postgres.aggregates.ArrayAgg</code>, <code class="docutils literal notranslate">JSONBAgg</code>, and <code class="docutils literal notranslate">StringAgg</code> aggregates no longer return <code class="docutils literal notranslate">[]</code>, <code class="docutils literal notranslate">[]</code>, and <code class="docutils literal notranslate">''</code>, respectively, when there are no rows.</li> <li>The <code class="docutils literal notranslate">USE_L10N</code> setting is removed.</li> <li>The <code class="docutils literal notranslate">USE_DEPRECATED_PYTZ</code> transitional setting is removed.</li> <li>Support for <code class="docutils literal notranslate">pytz</code> timezones is removed.</li> <li>The <code class="docutils literal notranslate">is_dst</code> argument is removed from:<ul> <li><code class="docutils literal notranslate">QuerySet.datetimes()</code></li> <li><code class="docutils literal notranslate">django.utils.timezone.make_aware()</code></li> <li><code class="docutils literal notranslate">django.db.models.functions.Trunc()</code></li> <li><code class="docutils literal notranslate">django.db.models.functions.TruncSecond()</code></li> <li><code class="docutils literal notranslate">django.db.models.functions.TruncMinute()</code></li> <li><code class="docutils literal notranslate">django.db.models.functions.TruncHour()</code></li> <li><code class="docutils literal notranslate">django.db.models.functions.TruncDay()</code></li> <li><code class="docutils literal notranslate">django.db.models.functions.TruncWeek()</code></li> <li><code class="docutils literal notranslate">django.db.models.functions.TruncMonth()</code></li> <li><code class="docutils literal notranslate">django.db.models.functions.TruncQuarter()</code></li> <li><code class="docutils literal notranslate">django.db.models.functions.TruncYear()</code></li> </ul> </li> <li>The <code class="docutils literal notranslate">django.contrib.gis.admin.GeoModelAdmin</code> and <code class="docutils literal notranslate">OSMGeoAdmin</code> classes are removed.</li> <li>The undocumented <code class="docutils literal notranslate">BaseForm._html_output()</code> method is removed.</li> <li>The ability to return a <code class="docutils literal notranslate">str</code>, rather than a <code class="docutils literal notranslate">SafeString</code>, when rendering an <code class="docutils literal notranslate">ErrorDict</code> and <code class="docutils literal notranslate">ErrorList</code> is removed.</li> </ul> See <a class="reference internal" href="../4.1/#deprecated-features-4-1">Features deprecated in 4.1</a> for details on these changes, including how to remove usage of these features. <ul class="simple"> <li>The <code class="docutils literal notranslate">SitemapIndexItem.__str__()</code> method is removed.</li> <li>The <code class="docutils literal notranslate">CSRF_COOKIE_MASKED</code> transitional setting is removed.</li> <li>The <code class="docutils literal notranslate">name</code> argument of <code class="docutils literal notranslate">django.utils.functional.cached_property()</code> is removed.</li> <li>The <code class="docutils literal notranslate">opclasses</code> argument of <code class="docutils literal notranslate">django.contrib.postgres.constraints.ExclusionConstraint</code> is removed.</li> <li>The undocumented ability to pass <code class="docutils literal notranslate">errors=None</code> to <code class="docutils literal notranslate">SimpleTestCase.assertFormError()</code> and <code class="docutils literal notranslate">assertFormsetError()</code> is removed.</li> <li><code class="docutils literal notranslate">django.contrib.sessions.serializers.PickleSerializer</code> is removed.</li> <li>The usage of <code class="docutils literal notranslate">QuerySet.iterator()</code> on a queryset that prefetches related objects without providing the <code class="docutils literal notranslate">chunk_size</code> argument is no longer allowed.</li> <li>Passing unsaved model instances to related filters is no longer allowed.</li> <li><code class="docutils literal notranslate">created=True</code> is required in the signature of <code class="docutils literal notranslate">RemoteUserBackend.configure_user()</code> subclasses.</li> <li>Support for logging out via <code class="docutils literal notranslate">GET</code> requests in the <code class="docutils literal notranslate">django.contrib.auth.views.LogoutView</code> and <code class="docutils literal notranslate">django.contrib.auth.views.logout_then_login()</code> is removed.</li> <li>The <code class="docutils literal notranslate">django.utils.timezone.utc</code> alias to <code class="docutils literal notranslate">datetime.timezone.utc</code> is removed.</li> <li>Passing a response object and a form/formset name to <code class="docutils literal notranslate">SimpleTestCase.assertFormError()</code> and <code class="docutils literal notranslate">assertFormSetError()</code> is no longer allowed.</li> <li>The <code class="docutils literal notranslate">django.contrib.gis.admin.OpenLayersWidget</code> is removed.</li> </ul> <ul class="simple"> <li>The <code class="docutils literal notranslate">django.contrib.auth.hashers.CryptPasswordHasher</code> is removed.</li> </ul> <ul class="simple"> <li>The <code class="docutils literal notranslate">"django/forms/default.html"</code> and <code class="docutils literal notranslate">"django/forms/formsets/default.html"</code> templates are removed.</li> <li>The default form and formset rendering style is changed to the div-based.</li> <li>Passing <code class="docutils literal notranslate">nulls_first=False</code> or <code class="docutils literal notranslate">nulls_last=False</code> to <code class="docutils literal notranslate">Expression.asc()</code> and <code class="docutils literal notranslate">Expression.desc()</code> methods, and the <code class="docutils literal notranslate">OrderBy</code> expression is no longer allowed.</li> </ul> </div> </div> </div> <div class="browse-horizontal"> <div class="left"><a rel="prev" href="../5.0.1/"> Django 5.0.1 release notes</a></div> <div class="right"><a rel="next" href="../4.2.16/">Django 4.2.16 release notes </a></div> </div> <a href="#top" class="backtotop"> Back to Top</a> </div> <h1 class="visuallyhidden">Additional Information</h1> <div role="complementary"> <div class="fundraising-sidebar"> <h2>Support Django!</h2> <div class="small-heart"> <img src="https://static.djangoproject.com/img/fundraising-heart.cd6bb84ffd33.svg" alt="Support Django!" /> </div> <div class="small-cta"> <ul class="list-links-small"> <li><a href="https://www.djangoproject.com/fundraising/"> Murat Ağalday donated to the Django Software Foundation to support Django development. Donate today! </a></li> </ul> </div> </div> <h2>Contents</h2> <ul> <li><a class="reference internal" href="#">Django 5.0 release notes</a><ul> <li><a class="reference internal" href="#python-compatibility">Python compatibility</a></li> <li><a class="reference internal" href="#third-party-library-support-for-older-version-of-django">Third-party library support for older version of Django</a></li> <li><a class="reference internal" href="#what-s-new-in-django-5-0">What’s new in Django 5.0</a><ul> <li><a class="reference internal" href="#facet-filters-in-the-admin">Facet filters in the admin</a></li> <li><a class="reference internal" href="#simplified-templates-for-form-field-rendering">Simplified templates for form field rendering</a></li> <li><a class="reference internal" href="#database-computed-default-values">Database-computed default values</a></li> <li><a class="reference internal" href="#database-generated-model-field">Database generated model field</a></li> <li><a class="reference internal" href="#more-options-for-declaring-field-choices">More options for declaring field choices</a></li> <li><a class="reference internal" href="#minor-features">Minor features</a><ul> <li><a class="reference internal" href="#django-contrib-admin"><code class="xref py py-mod docutils literal notranslate">django.contrib.admin</code></a></li> <li><a class="reference internal" href="#django-contrib-auth"><code class="xref py py-mod docutils literal notranslate">django.contrib.auth</code></a></li> <li><a class="reference internal" href="#django-contrib-contenttypes"><code class="xref py py-mod docutils literal notranslate">django.contrib.contenttypes</code></a></li> <li><a class="reference internal" href="#django-contrib-gis"><code class="xref py py-mod docutils literal notranslate">django.contrib.gis</code></a></li> <li><a class="reference internal" href="#django-contrib-messages"><code class="xref py py-mod docutils literal notranslate">django.contrib.messages</code></a></li> <li><a class="reference internal" href="#django-contrib-postgres"><code class="xref py py-mod docutils literal notranslate">django.contrib.postgres</code></a></li> <li><a class="reference internal" href="#asynchronous-views">Asynchronous views</a></li> <li><a class="reference internal" href="#decorators">Decorators</a></li> <li><a class="reference internal" href="#error-reporting">Error Reporting</a></li> <li><a class="reference internal" href="#file-storage">File Storage</a></li> <li><a class="reference internal" href="#forms">Forms</a></li> <li><a class="reference internal" href="#internationalization">Internationalization</a></li> <li><a class="reference internal" href="#migrations">Migrations</a></li> <li><a class="reference internal" href="#models">Models</a></li> <li><a class="reference internal" href="#pagination">Pagination</a></li> <li><a class="reference internal" href="#signals">Signals</a></li> <li><a class="reference internal" href="#templates">Templates</a></li> <li><a class="reference internal" href="#tests">Tests</a></li> <li><a class="reference internal" href="#validators">Validators</a></li> </ul> </li> </ul> </li> <li><a class="reference internal" href="#backwards-incompatible-changes-in-5-0">Backwards incompatible changes in 5.0</a><ul> <li><a class="reference internal" href="#database-backend-api">Database backend API</a></li> <li><a class="reference internal" href="#id1"><code class="xref py py-mod docutils literal notranslate">django.contrib.gis</code></a></li> <li><a class="reference internal" href="#django-contrib-sitemaps"><code class="xref py py-mod docutils literal notranslate">django.contrib.sitemaps</code></a></li> <li><a class="reference internal" href="#dropped-support-for-mysql-8-0-11">Dropped support for MySQL < 8.0.11</a></li> <li><a class="reference internal" href="#using-create-defaults-exact-may-now-be-required-with-queryset-update-or-create">Using <code class="docutils literal notranslate">create_defaults__exact</code> may now be required with <code class="docutils literal notranslate">QuerySet.update_or_create()</code></a></li> <li><a class="reference internal" href="#migrating-existing-uuidfield-on-mariadb-10-7">Migrating existing <code class="docutils literal notranslate">UUIDField</code> on MariaDB 10.7+</a></li> <li><a class="reference internal" href="#miscellaneous">Miscellaneous</a></li> </ul> </li> <li><a class="reference internal" href="#features-deprecated-in-5-0">Features deprecated in 5.0</a><ul> <li><a class="reference internal" href="#id2">Miscellaneous</a></li> </ul> </li> <li><a class="reference internal" href="#features-removed-in-5-0">Features removed in 5.0</a></li> </ul> </li> </ul> <h2>Browse</h2> <ul> <li>Prev: <a rel="prev" href="../5.0.1/">Django 5.0.1 release notes</a></li> <li>Next: <a rel="next" href="../4.2.16/">Django 4.2.16 release notes</a></li> <li><a href="https://docs.djangoproject.com/en/5.0/contents/">Table of contents</a></li> <li><a href="https://docs.djangoproject.com/en/5.0/genindex/">General Index</a></li> <li><a href="https://docs.djangoproject.com/en/5.0/py-modindex/">Python Module Index</a></li> </ul> <h2>You are here:</h2> <ul> <li> <a href="https://docs.djangoproject.com/en/5.0/">Django 5.0 documentation</a> <ul><li><a href="../">Release notes</a> <ul><li>Django 5.0 release notes</li></ul> </li></ul> </li> </ul> <h2 id="getting-help-sidebar">Getting help</h2> <dl class="list-links"> <dt><a href="https://docs.djangoproject.com/en/5.0/faq/">FAQ</a></dt> <dd>Try the FAQ — it's got answers to many common questions.</dd> <dt><a href="/en/stable/genindex/">Index</a>, <a href="/en/stable/py-modindex/">Module Index</a>, or <a href="/en/stable/contents/">Table of Contents</a></dt> <dd>Handy when looking for specific information.</dd> <dt><a href="https://groups.google.com/group/django-users/">django-users mailing list</a></dt> <dd>Search for information in the archives of the django-users mailing list, or post a question.</dd> <dt><a href="irc://irc.libera.chat/django">#django IRC channel</a></dt> <dd>Ask a question in the #django IRC channel, or search the IRC logs to see if it’s been asked before.</dd> <dt><a href="https://discord.gg/xcRH6mN4fa">Django Discord Server</a></dt> <dd>Join the Django Discord Community.</dd> <dt><a href="https://forum.djangoproject.com/">Official Django Forum</a></dt> <dd>Join the community on the Django Forum.</dd> <dt><a href="https://code.djangoproject.com/">Ticket tracker</a></dt> <dd>Report bugs with Django or Django documentation in our ticket tracker.</dd> </dl> <h2>Download:</h2> Offline (Django 5.0): <a href="https://media.djangoproject.com/docs/django-docs-5.0-en.zip">HTML</a> | <a href="https://media.readthedocs.org/pdf/django/5.0.x/django.pdf">PDF</a> | <a href="https://media.readthedocs.org/epub/django/5.0.x/django.epub">ePub</a> Provided by <a href="https://readthedocs.org/">Read the Docs</a>. </div> </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>  <div role="contentinfo"> <div class="subfooter"> <div class="container"> <h1 class="visuallyhidden">Django Links</h1> <div class="column-container"> <div class="col-learn-more"> <h2>Learn More</h2> <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"> <h2>Get Involved</h2> <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"> <h2>Get Help</h2> <ul> <li><a href="https://docs.djangoproject.com/en/stable/faq/">Getting Help FAQ</a> </li> <li><a href="irc://irc.libera.chat/django">#django IRC channel</a></li> <li><a href="https://discord.gg/xcRH6mN4fa" 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"> <h2>Follow Us</h2> <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> <li><a href="https://groups.google.com/forum/#!forum/django-users">Django Users Mailing List</a></li> </ul> </div> <div class="col-support-us"> <h2>Support Us</h2> <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-2024 <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> </div> <script> function extless(input) { return input.replace(/(.*)\.[^.]+$/, '$1'); } var require = { shim: { 'jquery': [], 'jquery.inview': ["jquery"], 'jquery.payment': ["jquery"], 'jquery.flot': ["jquery"], 'jquery.unveil': ["jquery"], 'stripe': { exports: 'Stripe' } }, paths: { "jquery": extless("https://static.djangoproject.com/js/lib/jquery/dist/jquery.min.eb6af28969bd.js"), "jquery.inview": extless("https://static.djangoproject.com/js/lib/jquery.inview/jquery.inview.min.4edba1c65592.js"), "jquery.payment": extless("https://static.djangoproject.com/js/lib/jquery.payment/lib/jquery.payment.e99c05ca79ae.js"), "jquery.unveil": extless("https://static.djangoproject.com/js/lib/unveil/jquery.unveil.min.ac79eb277093.js"), "jquery.flot": extless("https://static.djangoproject.com/js/lib/jquery-flot/jquery.flot.min.9964206e9d7f.js"), "clipboard": extless("https://static.djangoproject.com/js/lib/clipboard/dist/clipboard.min.bd70fd596a23.js"), "mod/floating-warning": extless("https://static.djangoproject.com/js/mod/floating-warning.a21b2abd2884.js"), "mod/list-collapsing": extless("https://static.djangoproject.com/js/mod/list-collapsing.c1a08d3ef9e9.js"), "mod/list-feature": extless("https://static.djangoproject.com/js/mod/list-feature.73529480f25b.js"), "mod/mobile-menu": extless("https://static.djangoproject.com/js/mod/mobile-menu.8e7e063d3524.js"), "mod/version-switcher": extless("https://static.djangoproject.com/js/mod/version-switcher.c56ff7ed5481.js"), "mod/search-key": extless("https://static.djangoproject.com/js/mod/search-key.ae7292327b47.js"), "mod/stripe-change-card": extless("https://static.djangoproject.com/js/mod/stripe-change-card.682c710317a8.js"), "mod/switch-dark-mode": extless("https://static.djangoproject.com/js/mod/switch-dark-mode.69777ee87b91.js"), "mod/console-tabs": extless("https://static.djangoproject.com/js/mod/console-tabs.70ce882faaf3.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.48270eac7c0b.js" src="https://static.djangoproject.com/js/lib/require.177879fbe7dd.js"></script> </body> </html>