Forms for user registration — django-registration 0.8 documentation

### Navigation

- index
- modules |
- next |
- previous |
- django-registration 0.8 documentation »

# Forms for user registration

Several form classes are provided with django-registration, covering common cases for gathering account information and implementing common constraints for user registration. These forms were designed with django-registration’s default backend in mind, but may also be useful in other situations.

class `registration.forms.` `RegistrationForm`

  A simple form for registering an account. Has the following fields, all of which are required:

  `username`
    The username to use for the new account. This is represented as a text input which validates that the username is unique, consists entirely of alphanumeric characters and underscores and is at most 30 characters in length.
  `email`
    The email address to use for the new account. This is represented as a text input which accepts email addresses up to 75 characters in length.
  `password1`
    The password to use for the new account. This represented as a password input (`input type="password"` in the rendered HTML).
  `password2`
    The password to use for the new account. This represented as a password input (`input type="password"` in the rendered HTML).

  The constraints on usernames and email addresses match those enforced by Django’s default authentication backend for instances of `django.contrib.auth.models.User`. The repeated entry of the password serves to catch typos.

  Because it does not apply to any single field of the form, the validation error for mismatched passwords is attached to the form itself, and so must be accessed via the form’s `non_field_errors()` method.

class `registration.forms.` `RegistrationFormTermsOfService`

  A subclass of `RegistrationForm` which adds one additional, required field:

  `tos`
    A checkbox indicating agreement to the site’s terms of service/user agreement.

class `registration.forms.` `RegistrationFormUniqueEmail`

  A subclass of `RegistrationForm` which enforces uniqueness of email addresses in addition to uniqueness of usernames.

class `registration.forms.` `RegistrationFormNoFreeEmail`

  A subclass of `RegistrationForm` which disallows registration using addresses from some common free email providers. This can, in some cases, cut down on automated registration by spambots.

  By default, the following domains are disallowed for email addresses:

  - `aim.com`
  - `aol.com`
  - `email.com`
  - `gmail.com`
  - `googlemail.com`
  - `hotmail.com`
  - `hushmail.com`
  - `msn.com`
  - `mail.ru`
  - `mailinator.com`
  - `live.com`
  - `yahoo.com`

  To change this, subclass this form and set the class attribute `bad_domains` to a list of domains you wish to disallow.

### Navigation

- index
- modules |
- next |
- previous |
- django-registration 0.8 documentation »