diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/ref/settings.txt | 4 | ||||
| -rw-r--r-- | docs/topics/auth/customizing.txt | 8 |
2 files changed, 11 insertions, 1 deletions
diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt index 382449e22e..5b51e45cc9 100644 --- a/docs/ref/settings.txt +++ b/docs/ref/settings.txt @@ -2377,7 +2377,9 @@ 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. + without serious effort. It is intended to be set at the project start, + and the model it refers to must be available in the first migration of + the app that it lives in. See :ref:`auth-custom-user` for more details. .. setting:: LOGIN_REDIRECT_URL diff --git a/docs/topics/auth/customizing.txt b/docs/topics/auth/customizing.txt index 0fd2b41dd2..7141d9ccd3 100644 --- a/docs/topics/auth/customizing.txt +++ b/docs/topics/auth/customizing.txt @@ -392,6 +392,14 @@ use as your User model. fix your schema, port your data from the old user table, and possibly manually reapply some migrations. +.. warning:: + + Due to limitations of Django's dynamic dependency feature for swappable + models, you must ensure that the model referenced by :setting:`AUTH_USER_MODEL` + is created in the first migration of its app (usually called ``0001_initial``); + otherwise, you will have dependency issues. + + Referencing the User model -------------------------- |