[Django] #36599: Wrong default value of DEFAULT_AUTO_FIELD in the documentation

2 views
Skip to first unread message

Django

unread,
Sep 8, 2025, 6:58:00 AM (yesterday) Sep 8
to django-...@googlegroups.com
#36599: Wrong default value of DEFAULT_AUTO_FIELD in the documentation
-------------------------------------+-------------------------------------
Reporter: Salman Mohammadi | Type:
| Cleanup/optimization
Status: new | Component:
| Documentation
Version: 5.2 | Severity: Normal
Keywords: | Triage Stage:
| Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Hi everyone,

in the ''dev'' version of the documentation, we can see it correctly that
the default value for DEFAULT_AUTO_FIELD is:
`django.db.models.BigAutoField` {1} but it is not the case in the docs
versions of 5.2 {2} and 4.2 {3} which both have the default value which is
mentioned in the ''dev'' version but the respected docs have not been
updated and mentions the old default value which was
`'django.db.models.AutoField'`


- {1} https://docs.djangoproject.com/en/dev/ref/settings/#std-setting-
DEFAULT_AUTO_FIELD
- {2} https://docs.djangoproject.com/en/5.2/ref/settings/#std-setting-
DEFAULT_AUTO_FIELD
- {3} https://docs.djangoproject.com/en/4.2/ref/settings/#std-setting-
DEFAULT_AUTO_FIELD
--
Ticket URL: <https://code.djangoproject.com/ticket/36599>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

Django

unread,
Sep 8, 2025, 8:31:31 AM (yesterday) Sep 8
to django-...@googlegroups.com
#36599: Wrong default value of DEFAULT_AUTO_FIELD in the documentation
-------------------------------------+-------------------------------------
Reporter: Salman Mohammadi | Owner: (none)
Type: | Status: closed
Cleanup/optimization |
Component: Documentation | Version: 5.2
Severity: Normal | Resolution: invalid
Keywords: | Triage Stage:
| Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by Tim Graham):

* resolution: => invalid
* status: new => closed

Comment:

The documentation is correct (the dev documentation changed in #36564).
Your confusion may be that in older versions, the default startproject
template had `DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'`.
That's different from the default value in `django.conf.global_settings`.
--
Ticket URL: <https://code.djangoproject.com/ticket/36599#comment:1>

Django

unread,
Sep 8, 2025, 8:54:19 AM (yesterday) Sep 8
to django-...@googlegroups.com
#36599: Wrong default value of DEFAULT_AUTO_FIELD in the documentation
-------------------------------------+-------------------------------------
Reporter: Salman Mohammadi | Owner: (none)
Type: | Status: closed
Cleanup/optimization |
Component: Documentation | Version: 5.2
Severity: Normal | Resolution: invalid
Keywords: | Triage Stage:
| Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Comment (by Salman Mohammadi):

Oh, thank you for the explanation.
--
Ticket URL: <https://code.djangoproject.com/ticket/36599#comment:2>
Reply all
Reply to author
Forward
0 new messages