diff --git a/docs/topics/auth/customizing.txt b/docs/topics/auth/customizing.txt index f974b5647dd..f15ce847cd9 100644 --- a/docs/topics/auth/customizing.txt +++ b/docs/topics/auth/customizing.txt @@ -668,6 +668,8 @@ custom profile fields. This class 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: + Custom users and the built-in auth forms ---------------------------------------- diff --git a/docs/topics/auth/default.txt b/docs/topics/auth/default.txt index 6847080c1c2..4072c517716 100644 --- a/docs/topics/auth/default.txt +++ b/docs/topics/auth/default.txt @@ -919,6 +919,14 @@ If you don't want to use the built-in views, but want the convenience of not having to write forms for this functionality, the authentication system provides several built-in forms located in :mod:`django.contrib.auth.forms`: +.. note:: + The built-in authentication forms make certain assumptions about the user + model that they are working with. If you're using a :ref:`custom User model + `, it may be necessary to define your own forms for the + authentication system. For more information, refer to the documentation + about :ref:`using the built-in authentication forms with custom user models + `. + .. class:: AdminPasswordChangeForm A form used in the admin interface to change a user's password.