diff --git a/docs/topics/auth/customizing.txt b/docs/topics/auth/customizing.txt index 8f78c2b4a78..b205f5fda0e 100644 --- a/docs/topics/auth/customizing.txt +++ b/docs/topics/auth/customizing.txt @@ -451,6 +451,8 @@ different User model. class Article(models.Model): author = models.ForeignKey(settings.AUTH_USER_MODEL) +.. _specifying-custom-user-model: + Specifying a custom User model ------------------------------ @@ -691,10 +693,12 @@ Extending Django's default User ------------------------------- If you're entirely happy with Django's :class:`~django.contrib.auth.models.User` -model and you just want to add some additional profile information, you can +model and you just want to add some additional profile information, you could simply subclass ``django.contrib.auth.models.AbstractUser`` and add your -custom profile fields. This class provides the full implementation of the -default :class:`~django.contrib.auth.models.User` as an :ref:`abstract model +custom profile fields, although we'd recommend a separate model as described in +the "Model design considerations" note of :ref:`specifying-custom-user-model`. +``AbstractUser`` provides the full implementation of the default +:class:`~django.contrib.auth.models.User` as an :ref:`abstract model `. .. _custom-users-and-the-built-in-auth-forms: