Last Updated : 12 Jul, 2025
ModelForm is a class that automatically generates a "form" from a Django model. It reduces boilerplate code by linking your form fields directly to your model fields, making form creation faster, cleaner, and less error-prone. It also provides built-in methods and validation to streamline form processing.
Example of converting a model into a Django Form?To explain the working of the project, we will use project geeksforgeeks, create a model and map it to Django forms.
Step 1: Create the ModelRefer to the following articles to check how to create a project and an app in Django.
In geeks/models.py, define a model as follows:
Python
from django.db import models
class GeeksModel(models.Model):
title = models.CharField(max_length = 200)
description = models.TextField()
last_modified = models.DateTimeField(auto_now_add = True)
img = models.ImageField(upload_to = "images/")
def __str__(self):
return self.title
This model has a title, description, timestamp, and an image.
Step 2: Register Your AppBefore creating migrations, ensure the geeks app is added to the INSTALLED_APPS list in your project's settings.py:
Step 3: Make Migrations and MigrateINSTALLED_APPS = [
# other apps,
'geeks',
]
Run the following commands to create and apply the migration for your model:
Step 4: Verify Model CreationPython manage.py makemigrations
Python manage.py migrate
You can verify that the model is registered by visiting the Django admin interface:
Step 5: Create the ModelFormhttp://127.0.0.1:8000/admin/geeks/geeksmodel/add/
In geeks/forms.py, create a ModelForm class to automatically generate a form based on your model:
Python
from django import forms
from .models import GeeksModel
class GeeksForm(forms.ModelForm):
class Meta:
model = GeeksModel
fields = "__all__"
This form takes two arguments fields or exclude.
fields vs exclude
class PartialGeeksForm(forms.ModelForm):
class Meta:
model = GeeksModel
exclude = ['img']
Step 6: Use the ModelForm in Your View
Update your view to instantiate and process the form data:
Python
from django.shortcuts import render
from .forms import GeeksForm
def home_view(request):
context ={}
form = GeeksForm(request.POST or None, request.FILES or None)
if form.is_valid():
form.save()
context['form']= form
return render(request, "home.html", context)
Everything is set, Now visit "http://127.0.0.1:8000/", Now you can see that every model field is mapped into a form field and displayed correspondingly. Field mappings are discussed later in this article. So now let's try entering data into the form and check if it gets saved into the database.
Hit submit and Bingo the form gets saved automatically to database. We can verify it at:
Field typeshttp://localhost:8000/admin/geeks/geeksmodel/
The generated Form class will have a form field for every model field specified, in the order specified in the fields attribute. Each model field has a corresponding default form field. For example, a CharField on a model is represented as a CharField on a form. A model ManyToManyField is represented as a MultipleChoiceField. Here is the full list of conversions:
Model Field Form Field AutoField Not represented in the form BigAutoField Not represented in the form BigIntegerField IntegerField with min_value set to -9223372036854775808 and max_value set to 9223372036854775807. BinaryField CharField, if editable is set to True on the model field, otherwise not represented in the form. BooleanField BooleanField, or NullBooleanField if null=True. CharField CharField with max_length set to the model field’s max_length and empty_value set to None if null=True. DateField DateField DateTimeField DateTimeField DecimalField DecimalField DurationField DurationField EmailField EmailField FileField FileField FilePathField FilePathField FloatField FloatField ForeignKey ModelChoiceField ImageField ImageField IntegerField IntegerField IPAddressField IPAddressField GenericIPAddressField GenericIPAddressField ManyToManyField ModelMultipleChoiceField NullBooleanField NullBooleanField PositiveIntegerField IntegerField PositiveSmallIntegerField IntegerField SlugField SlugField SmallAutoField Not represented in the form TextField CharField with widget=forms.Textarea TimeField TimeField URLField URLFieldRead Next Article: Render Form Fields Manually
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4