summaryrefslogtreecommitdiff
path: root/docs/topics
diff options
context:
space:
mode:
authorAndrew Godwin <andrew@aeracode.org>2014-06-19 23:48:29 -0700
committerAndrew Godwin <andrew@aeracode.org>2014-06-19 23:48:29 -0700
commit08221d1b5c1eec782c792818a2aa4a74ca7f1fcb (patch)
tree9f43d773a30f9c59680290d18004da5c83506d92 /docs/topics
parent9f4852f649fad459a451995c4a17a7d8db5972c9 (diff)
Fixed #22874: Document that AUTH_USER_MODEL must be in first migration
Diffstat (limited to 'docs/topics')
-rw-r--r--docs/topics/auth/customizing.txt8
1 files changed, 8 insertions, 0 deletions
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
--------------------------