24

I have a form for address information. One of the fields is for the address country. Currently this is just a textbox. I would like a drop down list (of ISO 3166 countries) for this. I'm a django newbie so I haven't even used a Django Select widget yet. What is a good way to do this?

Hard-code the choices in a file somewhere? Put them in the database? In the template?

0

16 Answers 16

35

Check out "choices" parameter of a CharField.

You might also want to take a look at django-countries.

4
  • 1
    Note that there are two django-countries projects. The one linked has much more comprehensive data, but appears not to be actively maintained, so watch out for out-of-date data.
    – Marcin
    Commented Nov 22, 2011 at 16:14
  • 1
    Seems to be living on github now: github.com/SmileyChris/django-countries
    – creimers
    Commented Sep 26, 2015 at 9:48
  • @creimers Thanks! Updated accordingly. Commented Sep 26, 2015 at 13:11
  • 2
    Instead of the additional django-countries dependency, you could use pytz, which is already included with Django. See example below.
    – djvg
    Commented Oct 21, 2020 at 13:39
25

Django Countries

from django_countries.fields import CountryField

class Foo(models.Model):
    country = CountryField()
3
  • @monokrome So what you're saying is that I'm right, and you need to do extra work to represent the country name in any other format.
    – Marcin
    Commented Jul 10, 2012 at 19:07
  • 3
    For some reason, that import didn't work form me. I use from django_countries.fields import CountryField. Commented Oct 23, 2015 at 14:40
  • @JohnLehmann maybe it's changed, this is 5 years old. Updated.
    – aehlke
    Commented Oct 25, 2015 at 17:15
11

Ended up using the below snippet which basically defines a tuple of tuples of two character country codes. Additionally it defines a custom field type called CountryField and defaults the choices parameter to the above defined tuple. This automatically gets rendered as a drop down list.

http://djangosnippets.org/snippets/494/

2
  • 2
    django-countries provides exactly the same. Its a reusable component.
    – viam0Zah
    Commented Aug 11, 2010 at 13:50
  • 2
    Someone in the comment at djangosnippets recommends using this snippet instead: djangosnippets.org/snippets/1476 It is more up to date and fixes the maxlength bug. Commented Jul 6, 2011 at 14:53
8

Django Countries

from django_countries.countries import COUNTRIES

class CountryForm(forms.Form):
      country= forms.ChoiceField(COUNTRIES)
4
  • 1
    django-countries has a CountryField class now.
    – aehlke
    Commented Sep 13, 2010 at 12:19
  • 2
    hi..there is one problem, when this form is rendered, by defaul it shows 'Afghanistan', which is the first country in the choice set of course..but what if the country field is not required? meaning, by default shows ---- or similar
    – Mona
    Commented Jul 5, 2013 at 8:46
  • 2
    The import location seems to have changed it's now from django_countries import countries
    – Parham
    Commented Dec 5, 2015 at 22:48
  • Official documentation for using django_countries in a forms.Form: github.com/SmileyChris/django-countries#custom-forms
    – Padawan
    Commented Aug 24, 2021 at 15:36
5

Two low mantained projects:

http://code.google.com/p/django-countries/

https://github.com/strange/django-country-utils

Two snippets:

http://djangosnippets.org/snippets/494/

http://djangosnippets.org/snippets/1476/

For now, I am going for a snippet.

5

As previous answers have stated, there is a CountryField in django-countries. This is a model field.

If a form field is needed in a plain form (not model form), in django-countries v3.x (definitely tested in 3.3) the following can be used:

from django_countries.data import COUNTRIES

class MyForm(forms.Form):
    country = forms.ChoiceField(sorted(COUNTRIES.items()))
1
  • 1
    This is helpful while creating a form with django-countries. Thanks !
    – ni8mr
    Commented May 15, 2017 at 6:52
4

UPDATE (Django >=4.0)

Using pytz.country_names was convenient in older Django versions, as described below, but Django >=4.0 uses zoneinfo instead of pytz. Details in the release notes and here.

Unfortunately, zoneinfo does not appear to offer an equivalent of pytz.country_names (as far as I know).

There is, however, an up-to-date list of ISO 3166 country names in Python's (first-party) tzdata package: iso3166.tab

Note that tzdata is already installed if you're using Django 4+ on Windows.

For illustrative purposes only, here's a quick & dirty way to parse the iso3166.tab file into a dict similar to pytz.country_names (Python 3.9+):

from importlib import resources

with resources.files('tzdata.zoneinfo').joinpath('iso3166.tab').open('r') as f:
    country_names = dict(
        line.rstrip('\n').split('\t', 1)
        for line in f
        if not line.startswith('#')
    )

Note, for Django's field choices, it would be easier to create a list directly, instead of a dict.

ORIGINAL (Django <4.0)

Django (<4.0) uses pytz (see e.g. django.utils.timezone), and pytz exposes a country_names dictionary, based on ISO 3166 (see pytz docs).

This pytz.country_names dictionary can be used to set your model field choices, or form field choices.

This might not cover all edge cases, but, at least, it does not add another obscure external dependency to your Django project.

Example for a model field (import pytz first):

country = models.CharField(max_length=2, choices=pytz.country_names.items())

Note that the dict keys (country codes) are all capitals.

One other thing to keep in mind, in case pytz is updated: as mentioned in the Django Model field reference

A new migration is created each time the order of choices changes.

3

Here is a nice library with countries (and not only): pycountry

Its main advantage is that it is a wrapper around Debian package pkg-isocodes (thus can updates automatically with it) compared to hard-coded countries in other solutions. It also has translations.

So if new country appears or existing countries will be merged together you do not need to change your code.

I found it useful to use this library and create a simple Django app with model Country for example

Then you can populate and keep up-to-date your 'country' table by means of custom django-admin command as described here: Writing custom django-admin commands

2

Link to package : django-countries
If looking for how to do it in forms :

$ pip install django-countries

>>> from django_countries.data import COUNTRIES

>>> Country = forms.ChoiceField(choices = sorted(COUNTRIES.items()))
1
  • consider adding a link to the package
    – DanielM
    Commented Jan 24, 2019 at 2:15
1

Put them in the database is a better way. Convenient to management.

1

I solved it by using multiple=True:

from django_countries.fields import CountryField    

class UserProfile(models.Model):
    countries = CountryField(multiple=True)

You can read more about it in the docs:

https://github.com/SmileyChris/django-countries

1

If you just want to have a country ChoiceField without installing django-choices you can create an extra file which holds a tuple with all choices from the Wikipedia Iso Country Codes:

import csv


# Get the file from: "http://geohack.net/gis/wikipedia-iso-country-codes.csv"
with open("wikipedia-iso-country-codes.csv") as f:
    file = csv.DictReader(f, delimiter=',')
    country_names = [line['English short name lower case'] for line in file]

# Create a tuple with the country names
with open("country_names.py", 'w') as f:
    f.write('COUNTRY_CHOICES = (\n')
    for c in country_names:
        f.write(f'    ("{c}", "{c}"),\n')
    f.write(')')

The created country_names.py file looks something like this:

COUNTRY_CHOICES = (
    ("Afghanistan", "Afghanistan"),
    ("Åland Islands", "Åland Islands"),
    ("Albania", "Albania"),
    ("Algeria", "Algeria"),
    ("American Samoa", "American Samoa"),
    ...
)

You can then use COUNTRY_CHOICES in your form like this:

from django import forms
from country_names import COUNTRY_CHOICES


class CountryForm(forms.Form):
    country= forms.ChoiceField(choices=COUNTRY_CHOICES)
0

Here is the solution:

from django_countries.fields import CountryField

class Foo(TimeStampedModel):

    country = CountryField()
0

SmileyChris seems to be pretty busy and unavailable, as the repository hasn't been updated since September. Thankfully, there is a repository that can be forked that is compatible with Django 3 and higher. This can be found here:

https://github.com/yunojuno/django-countries/tree/django-30

It passes all checks for a pull request, however SmileyChris has not responded to the merge request.

To install it just run pip install git+https://github.com/yunojuno/django-countries.git

0

If you are extending forms.Form class then you have to specify .formfield right after your Countryfield and then specify your attributes in formfield() parameter.

from django_countries.fields import CountryField
class CheckOutForm(forms.Form):
    country = CountryField().formfield()

But if you are extending from models.Model class then defining Coutryfield is enough.

from django_countries.fields import CountryField
    class CheckOutForm(models.Model):
        country = CountryField()
0

I guess, instead of trying with models fields such as ChoiceField or CharField and passing 'choices' as a parameter which contains list of countries as tuple values inside the list created outside in the models.py, Django has compact library to work with selecting country while filling the form.

from django-countries.fields import CountryField

class foo(models.Model):
   country = CountryField(blank_label='select country')
   ...

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.