[[PageOutline]]

= Adding an Email-based authentication model =

ContribAuthImprovements described and implemented a set of changes to allow for pluggable User models in contrib.auth. One of the primary motivators behind this change was to make it easy to implement email-based authentication. To make this even easier, #20824 describes an enhancement for Django to ship with a ready-to-use Email-based login model.

Some django-developer discussions that cover this topic:

 * https://groups.google.com/d/msg/django-developers/rb7v9kVAK3I/1yQYQPN-IcsJ

A number of solutions have been proposed. Here is a summary of the most viable candidates:

== Option 1: Something ==

Build a thing.

=== Advantages ===

 * Something

=== Problems ===

 * Something

== Final decision ==

To be determined.