django-registration 5.2.1¶

django-registration is an extensible application providing user registration functionality for Django sites.

It has built-in support for:

User registration with the default Django user model
User registration with many custom user models
Two-step (email an activation link) registration
One-step (register and be immediately logged in) registration

And is designed to be extensible to support use cases beyond what’s built in.

For example, to enable one-step registration, you’d add "django_registration" to your Django INSTALLED_APPS setting, then add the following to your site’s root URLconfig:

from django.urls import include, path

urlpatterns = [
    # Other URL patterns ...
    path("accounts/", include("django_registration.backends.one_step.urls")),
    path("accounts/", include("django.contrib.auth.urls")),
    # More URL patterns ...
]

And create a few templates (see the quick start guide for full details).

Documentation contents¶

Installation and configuration

Built-in registration workflows

For developers