Commit 44b00af9 authored by Andrew Godwin's avatar Andrew Godwin
Browse files

[1.7.x] Fixed #22874: Document that AUTH_USER_MODEL must be in first migration

parent bfe5f72c

docs/ref/settings.txt

+3 −1
Original line number Diff line number Diff line
@@ -2435,7 +2435,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

docs/topics/auth/customizing.txt

+8 −0
Original line number Diff line number Diff line
@@ -386,6 +386,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

--------------------------