summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/settings.txt6
1 files changed, 6 insertions, 0 deletions
diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt
index b4b432149b..6ea6c2c113 100644
--- a/docs/ref/settings.txt
+++ b/docs/ref/settings.txt
@@ -2432,6 +2432,12 @@ Default: 'auth.User'
The model to use to represent a User. See :ref:`auth-custom-user`.
+.. warning::
+ You cannot change the AUTH_USER_MODEL setting during the lifetime of
+ a project (i.e. once you have made and migrated models that depend on it)
+ without serious effort. It is intended to be set at the project start.
+ See :ref:`auth-custom-user` for more details.
+
.. setting:: LOGIN_REDIRECT_URL
LOGIN_REDIRECT_URL