From 08221d1b5c1eec782c792818a2aa4a74ca7f1fcb Mon Sep 17 00:00:00 2001 From: Andrew Godwin Date: Thu, 19 Jun 2014 23:48:29 -0700 Subject: Fixed #22874: Document that AUTH_USER_MODEL must be in first migration --- docs/topics/auth/customizing.txt | 8 ++++++++ 1 file changed, 8 insertions(+) (limited to 'docs/topics') 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 -------------------------- -- cgit v1.3