CountryField

A country field for Django models that provides all ISO 3166-1 countries as choices.

CountryField is based on Django's CharField, providing choices corresponding to the official ISO 3166-1 list of countries (with a default max_length of 2).

Consider the following model using a CountryField:

from django.db import models
from django_countries import CountryField

class Person(models.Model):
    name = models.CharField(max_length=100)
    country = CountryField()

Any Person instance will have a country attribute that you can use to get details of the person's country:

>>> person = Person(name='Chris', country='NZ')
>>> person.country
Country(code='NZ')
>>> person.country.name
u'New Zealand'
>>> person.country.flag
u'/static/flags/nz.gif'

This object (person.country in the example) is a Country instance, which is described below.

Country Choices

The django_countries.countries module contains some constants which can be used to generate choices lists for a Django Select form field.

COUNTRIES

A tuple of two part tuples, each consisting of a country code and the corresponding nicely titled (and translatable) country name.

COUNTRIES_PLUS

A tuple, similar to COUNTRIES, but also includes duplicates for countries that contain a comma (i.e. the non-comma'd version).

OFFICIAL_COUNTRIES

A dictionary where each key is a country code and each value is the corresponding official capitalised ISO 3166-1 English country name.