Skip to content
*DISCONTINUED* A custom registration and authorization backend that allows user signup via email.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


This app has been discontinued due to the give-up of django-registration. Also there are a lot of well developed and more extensive alternatives on the market.

Why don't you check out django-allauth:

It's already integrated in our project template (incl. templates & settings): It's configured the way we used this app.


We use django-registration in almost all our projects. However, we don't like Django's limited username and would like to allow our users to sign up via email.

This project provides a custom authentication backend which allows users to authenticate via email. We also provide an EmailRegistrationForm which checks if an email has already been taken.

Since we still have to store a username and since emails can easily be longer than 30 characters, the username will be computed as a md5 hexdigest of the email address.

We included a that overrides all URLs of django-registration and Django's auth with a clean and sane structure and you will find a default set of all necessary templates.


Install this package::

pip install -e git://

Add registration and registration_email to your INSTALLED_APPS::

    # all your other apps

Update your

url(r'^accounts/', include('registration_email.backends.default.urls')),

Add some settings to your


Run syncdb::

./ syncdb


django-registration-email introduces a new setting:


Default: lambda request, user: '/'

Function to return the URL to redirect to after a successful account activation. If you leave this at lambda request, user: '/' it will direct to your base URL.


Default: lambda request, user: '/'

Function to return the URL to redirect to after a successful account registration. If you leave this at lambda request, user: '/' it will direct to your base URL.

How to use a custom form

Let's say you want to collect the user's first name and last name when he registers. In order to achieve that, you need to do the following:

1. Create a custom form

Create a new app my_registration in your project and give it a where you override our EmailRegistrationForm and your desired extra fields:

from django import forms
from registration_email.forms import EmailRegistrationForm

class CustomEmailRegistrationForm(EmailRegistrationForm):
    first_name = forms.CharField()
    last_name = forms.CharField()

Do NOT override the form's save() method.

2. Override the URL

Now you need to tell the registration view that it is supposed to use the custom form:

# your main
from django.conf import settings
from registration.backends.simple.views import RegistrationView
from my_registration.forms import CustomEmailRegistrationForm

urlpatterns = [
                lambda request, user: '/'),

    url(r'^accounts/', include('registration_email.backends.default.urls')),

3. Create a signal handler

In the above I'm using the SimpleBackend. When you have a look at that backend you will see that the backend sends a signal after creating and logging in the user. The signal will get all parameters that we need in order to access the data that has been validated and sent by the form, so let's build a signal handler:

# in
from django.dispatch import receiver
from registration.signals import user_registered

def user_registered_handler(sender, user, request, **kwargs):
    user.first_name = request.POST.get('first_name')
    user.last_name = request.POST.get('last_name')

This method has the drawback that you save the user two times in a row. If you have concerns about performance you would have to create your own my_registration.backends.CustomRegistrationBackend class. That class would inherit registration.backends.simple.SimpleBackend and override the register method.

But really, we are talking about registration here, I can't imagine how saving the user twice could do any harm.


If you had another value for AUTHENTICATION_BACKENDS in your before it might be that it is saved in your django_session table. I found no other way around this than to delete the rows in that table.


  • Password reset link points to original django template
You can’t perform that action at this time.