Django Forms


In this chapter, we will learn to use Django Forms.

Django Forms

Forms are something that we have to deal with on a daily basis but yet they can be boring as they have a lot of fields to be filled in. Forms power everything from Google's search box to Facebook's Like button. Unless you’re planning to build websites and applications that do nothing but publish content and don’t accept input from users, you are going to need forms. 
Django abstracts most of the grunt work while working with forms such as validation or presentation. It also implements various security best practices. For the sake of this chapter, we’ll have a brief introduction to the following:
  • Overview of the form library in Django
  • Understanding the Rendering process
  • CSRF token for Untrusted input
  • Customizing error messages
  • Widgets
Now let’s take a look inside Django forms.

Django forms library

Django comes with its own library called forms to handle the states and tasks associated with forms. The Django forms library handles three common tasks:
  • HTML form generation.
  • Server-side validation of user input
  • HTML form redisplays in case of input errors
This library works in a similar fashion to Django’s model. Let’s create a simple signup form and see how things work.
To work with forms, create a new Python file named in your app and add the following code to it.
  1. from django import forms  
  2. from django.contrib.auth.models import User  
  3. class UserForm(forms.ModelForm):  
  4.     password = forms.CharField(widget=forms.PasswordInput)  
  5.     class Meta:  
  6.         model = User  
  7.         fields = ['username''email''password'
We imported the forms class and User model from Django. The beauty of Django lies in its ease. Did you notice that we didn’t have to create the User model? Django already has it created for us. It comes with all the general fields required for a user like first_name, last_name, email, password, user_permissions, etc. If you have any confusion regarding creating and manipulating models then please refer to the Django Models chapter.
Next, we defined our UserForm class which is inheriting from form class. There could be two ways to inherit from form class.


If our form is going to be used to directly add or edit a Django Model then you can use ModelForm. It is used to avoid the duplication of the model description as we did in the above case.


Forms created from forms. The form is manually configured by you. It is better to use this way of creating forms that do not directly interact with models. For example, a contact form or newsletter subscriptions form where database interaction is not required. One such example could be,
  1. from django import forms  
  2.  class ContactForm(forms.Form):  
  3.      subject = forms.CharField(max_length=100)  
  4.      message = forms.CharField()  
  5.      sender = forms.EmailField() 
Now let’s get back where we left our code explanation. We defined the password field as CharField and used the PasswordInput widget for this.
We also defined the Meta class for the UserForm class. Think of the Meta class as a container for configuration attributes of the outer class. The attributes of a class (for those that inherit from Model) are expected to be fields that correspond to their counterparts in the database. As new instances of your outer class are created, the class constructor will look to the Meta attribute for specific configuration details.
Now let’s update our views. Open and edit the following code to it.
  1. from django.shortcuts import render, redirect  
  2. from django.contrib.auth import login, authenticate  
  3. from django.views.generic import View  
  4. from webapp.forms import UserForm  
  6. class UserFormView(View):  
  7.   form_class = UserForm  
  8.   template_name = 'registration/signup.html'  
  9.   #display blank form  
  11.   def get(self, request):  
  12.     form = self.form_class(None)  
  13.     return render(request, self.template_name, {'form': form})  
  15.   # process form data  
  16.   def post(self, request):  
  17.     form = self.form_class(request.POST)  
  19.     if form.is_valid():  
  21.     user =  
  23.   #cleaned data  
  25.     username = form.cleaned_data['username']  
  26.     password = form.cleaned_data['password']  
  27.     user.set_password(password)  
  30.   #return user object if credentials are true  
  32.     user = authenticate(username=username, password=password)  
  34.     if user is not None:  
  35.       if user.is_active:  
  36.         login(request, user)  
  37.         return redirect('home')  
  38.     return render(request, self.template_name, {'form': form})  
Let’s try to understand the code here.
We did a bunch of imports from Django. These imports should be familiar to you as we’ve already talked about them already.
A view is a callable that takes a request and returns a response. A powerful way of using these generic views is to inherit from an existing view and override attributes (such as the template_name) or methods in a subclass to provide new values or methods which is pretty much what we did here.
We then defined the UserFormView class specifying the UserForm as parent class and template name. template_name refers to the template designated for signup which we’ll be creating next. For the moment; just link the template here.
There are two HTTP methods that are used to deal with forms; GET and POST. Any request that could be used to change the state of the system - for example, a request that makes changes in the database - should use POST. GET should be used only for requests that do not affect the state of the system. So we defined two different methods depending on the method chosen. If the GET method is used then the user will be displayed a blank form. If the POST method is used then the user will be able to register.
There are a few more things that we haven’t talked about like form.is_valid(), form.cleaned_data, and user.is_active. Let’s take a moment and see what these are.


Our registration process is kind of dependent on form.is_valid() function. The form goes through several states during its request-response cycle. In the simplest scenario, you need to present an empty form, and the user fills it incorrectly and submits it.
In other cases, they enter some invalid data and the form needs to be resubmitted until the entire form is valid.
This could be summarized as:
  • Unbound form
    a blank form is called an unbound form in Django.
  • Bound form
    the form that has filled fields is called a bound form in Django
  • Invalid form
    form submitted with errors would be called bound but invalid form
  • Valid
    submitted form without any error is called a bound and valid form
If is_valid() returns true, then every field in the bound form has valid data. If false, then there was some invalid data in at least one field or the form was not bound. This check is necessary as we don’t want the user to insert invalid data.


We need to get the ‘cleaned data’ from the form. What? Does this mean the values that the user has entered were not clean?
The answer is Yes. Following are a few reasons for that,
  • First
    You cannot trust users from the outside world with anything. There could be hackers sitting out there who can enter all sorts of exploits through a form to compromise the security of your site. So, any form of data must be sanitized before you use them. Think of it as how you have to wash your hands before a meal.
  • Secondly
    The field values are just strings. Although Django offers different field types like an integer or date or whatever, these would be sent as strings to your view. Surely, you would want to convert them to the appropriate Python types before use. The form class will do the conversion automatically for you while cleaning.
Last but not least, we check the status of the user just to make sure than he is active and the account is not being suspended by the admin. If user.is_active is TRUE and entered credentials were correct then we return a user object.
Now let’s create our template to display the signup form. Create a directory ‘registration’ inside your templates directory. Now create signup.html file inside ‘registration’ folder and add the following code to it.
  1. {% extends 'index.html' %}  
  2.  {% block content %}  
  3.   <h2>Sign up</h2>  
  4.   <form method="post">  
  5.   {% csrf_token %}  
  6.   {{ form.as_p }}  
  7.   <button type="submit">Sign up</button>  
  8.   </form>  
  9.  {% endblock %}  
What we did is defined our form using form tag same as HTML and specifying the method ‘post’.


It is the security mechanism against Cross-Site Request Forgery (CSRF) attacks for your forms This type of attack occurs when a malicious web site contains a link, a form button or some javascript that is intended to perform some action on your web site, using the credentials of a logged-in user who visits the malicious site in their browser. This token is used as a security measure against ensuring that the form was generated for the user by the original site and not by an attacker with similar fields. Django won’t accept form creation without CSRF token.
Lastly, we rendered the form using {{form.as_p}}. We’ll get back to the rendering process in a while.
Now the last thing before user registration becomes live; URL. Edit file as follow,
  1. from django.contrib import admin  
  2. from django.conf.urls import url  
  3. from webapp.views import *  
  4.  urlpatterns = [  
  5.    url('admin/',,  
  6.    url(r'^$', main_page, name='home'),  
  7.    url(r'^signup/$', UserFormView.as_view()),  
  8.  ]  
Now start your web server and navigate to and you should see the sign-up page that you created.

Understanding the Rendering Process

Take a close look at the form template that we just used. Don’t you think it works like magic? By that I mean the form itself may contain tens of fields but we use a simple {{form}} tag to render it all in the template. One more thing we used {{form.as_p}} tag. What this .as_p is?
Django supports three different representations for HTML form.
  1. as_p()
  2. as_ul()
  3. as_table()
as_p() would render the above form like this.
Figure 1: rendering form using {{form.as_p}}
You can try rendering the above form using the other two representations. The output for the other two representations would look something like this.
Figure 2 rendering form using {{form.as_ul}}
Figure 3: rendering form using {{form.as_table}}
Let’s try something. Try submitting an empty form. What happened? You won’t be able to submit the form as Django will prompt you that the fields are required. The same would happen if you try to register with a username that already exists or an invalid email address. But we didn’t implement any kind of validation. Remember that is_valid()? All this validation is working because of that. In other words, Django did everything for us.

Customizing Error message

Displaying a user-specific error message can be important. For example, you would have come across different sites that have a special demand for the password as it should contain at least one number, a special character, an upper case, etc. Suppose a user chooses a password but it doesn't contain a special character. Now it’s important to tell the user what is missing. Django provides us a way to customize the error messages using the error_messages property in the form field and set any string as an error message. It is also possible to define different error messages depending upon the type of error. Say we want to display a different error message if the form field is empty or if the format is not correct e.g. user set the only numeric password. We can do this by defining a dictionary as follows,
  1. class UserForm(forms.ModelForm):  
  2.   password = forms.CharField(widget=forms.PasswordInput, error_messages={  
  3.        'required''You must choose a password!'  
  4.   })  
This is a common practice to display customized error messages as it improves the quality of the website.


A widget is Django’s representation of an HTML input element. It is an effective way to customize the display of the form element. Whenever we specify a field on a form, Django will use a default widget that is appropriate to the type of data that is to be displayed. Suppose we want to create a contact form. It could be done in the following manner:
  1. class ContactForm(forms.Form):  
  3.   name = forms.CharField()  
  4.   email = forms.EmailField()  
  5.   message = forms.CharField(widget=forms.Textarea)  
This contact form will display a Textarea for the message. That’s not it; you can also specify the dimensions for Textarea if you want. Like this:
  1. message = forms.CharField(widget=forms.Textarea(attrs={'rows'5'cols'50}))  
Let’s see another example. We want to create a form that also lets the user choose their gender. This option can be provided as follows:
  1. class Form(forms.Form):  
  3.   Gender_Choices = ('Male''Female')  
  4.   Gender = forms.ChoiceField(widget=forms.RadioSelect, choices=Gender_Choices)  


In the next chapter, we will learn to perform CRUD operations in Django, 
Mehreen Tahir
396 6.3k 427.2k
Next » CRUD Operations In Django