VOOZH about

URL: https://www.geeksforgeeks.org/python/choicefield-django-forms/

⇱ ChoiceField - Django Forms - GeeksforGeeks

  • Courses
  • Tutorials
  • Interview Prep

ChoiceField - Django Forms

Last Updated : 12 Jul, 2025

ChoiceField in Django Forms is a field used to select a single value from a predefined list of choices. It is ideal for fields like State, Country, or any scenario where the user must pick one option from a set of known values.

  • Data type: Normalizes input to a string.
  • Default widget: Select (renders as a dropdown).
  • Required argument: choices, an iterable of 2-tuples representing the available options.

Syntax

field_name = forms.ChoiceField(choices=CHOICES, **options)

Here, choices is either:

  • An iterable of 2-tuples (e.g., [('1', 'One'), ('2', 'Two')]), or
  • A callable that returns such an iterable.

Example: Using ChoiceField in a Django Form

Suppose you have a Django project named geeksforgeeks with an app named geeks.

Step 1: Define choices and form in geeks/forms.py

Step 2: Add your app to INSTALLED_APPS in settings.py

INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'geeks', # Add your app here
]

Step 3: Create a view to render the form in geeks/views.py

Here we are importing that particular form from forms.py and creating an object of it in the view so that it can be rendered in a template.

Step 4: Create the template templates/home.html

Now, to initiate a Django form you need to create home.html where one would be designing the stuff as they like. Let's create a form in home.html.

Step 5: Map the view to a URL in geeks/urls.py

Step 6: Run the server

python manage.py runserver

👁 django-forms-choicefield
Choice Field

How to Use ChoiceField Data in Views

When the form is submitted, the selected choice value can be accessed from the request data:

Now let's try entering data into the field.

👁 django-choicefield-forms-1
Entering Data
  • For GET method, use request.GET
  • For POST method, use request.POST
👁 django-choicefield-forms
Fetched Data

Core Field Arguments for ChoiceField

You can customize your ChoiceField with these common arguments:

Field OptionsDescription
requiredBy default, each Field class assumes the value is required, so to make it not required you need to set required=False
labelThe label argument lets you specify the “human-friendly” label for this field. This is used when the Field is displayed in a Form.
label_suffixThe label_suffix argument lets you override the form’s label_suffix on a per-field basis.
widgetThe widget argument lets you specify a Widget class to use when rendering this Field.
help_textThe help_text argument lets you specify descriptive text for this Field. If you provide help_text, it will be displayed next to the Field when the Field is rendered by one of the convenience Form methods.
error_messagesThe error_messages argument lets you override the default messages that the field will raise. Pass in a dictionary with keys matching the error messages you want to override.
validatorsThe validators argument lets you provide a list of validation functions for this field.
localizeThe localize argument enables the localization of form data input, as well as the rendered output.
disabled.The disabled boolean argument, when set to True, disables a form field using the disabled HTML attribute so that it won’t be editable by users.
Comment
Article Tags: