Django Countries

Django Countries Logo

PyPI version Build status

A Django application that provides country choices for use with forms, flag icons static files, and a country field for models.

Documentation

📚 Read the full documentation

Quick Start

Install:

pip install django-countries

Add to INSTALLED_APPS:

INSTALLED_APPS = [
    # ...
    'django_countries',
]

Use in your models:

from django_countries.fields import CountryField

class Person(models.Model):
    country = CountryField()

Features

  • Country Field: Django model field with all ISO 3166-1 countries
  • Translated Names: Country names translated using Django's i18n system
  • Flag Icons: Static flag image files for all countries
  • REST Framework: Full Django REST Framework integration
  • GraphQL: Support for graphene-django
  • Multiple Selection: Support for multiple country selection

Support

  • Python: 3.10, 3.11, 3.12, 3.13, 3.14
  • Django: 4.2 (LTS), 5.2 (LTS), 6.0, 6.1
  • Django REST Framework: 3.14+

Contributing

Contributions are welcome! See the Contributing Guide for details.

Translations

Country names are translated using Django's standard gettext and imported from our Transifex project.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for SmileyChris from gravatar.com SmileyChris

Credits

PyPI data
Data sourced directly from PyPI's database.

Author: Chris Beaven

License

MIT License (MIT)

Requires

Python >=3.10

Provides Extra

pyuca

Tags

django countries flags

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django_countries-9.1.0.tar.gz (614.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

django_countries-9.1.0-py3-none-any.whl (928.0 kB view details)

Uploaded Python 3

File details

Details for the file django_countries-9.1.0.tar.gz.

File metadata

  • Download URL: django_countries-9.1.0.tar.gz
  • Upload date:
  • Size: 614.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Manjaro Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for django_countries-9.1.0.tar.gz
Algorithm Hash digest
SHA256 c1027417e1d1ebad5ac8fbc45a7578fc400c4fc895d6b865e001c16ba4be0939
MD5 40921b7a2d715afd546b6e5139043199
BLAKE2b-256 de7e54c144d213ccdd4f3e74e044c4b6cb7a0c2ccf2e738886fd61b9a0a376df

See more details on using hashes here.

File details

Details for the file django_countries-9.1.0-py3-none-any.whl.

File metadata

  • Download URL: django_countries-9.1.0-py3-none-any.whl
  • Upload date:
  • Size: 928.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Manjaro Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for django_countries-9.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 18c9f6e1a8e32356656b1db5ee94121310cbc3b91dc78171052a9ef9d57d5318
MD5 46fa1760c80e9923756f3f6f2a4563da
BLAKE2b-256 9c86f4a3a1bc0827e19bd0ec7267d80725e4f02916d34a279747672436a0aa5b

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

9.1.0 This release

2 files

9.0.0

2 files

8.2.0

2 files

8.1.1

2 files

8.1.0

2 files

8.0.1

2 files

8.0.0

2 files

Yanked

7.9.1

2 files

Yanked reason: Inadvertently dropped Python 3.7 support without a major version bump. Use 8.0.0 or later instead.

Yanked

7.9

2 files

Yanked reason: Inadvertently dropped Python 3.7 support without a major version bump. Use 8.0.0 or later instead.

Yanked

7.8

2 files

Yanked reason: Inadvertently dropped Python 3.7 support without a major version bump. Use 8.0.0 or later instead.

7.6.1

2 files

7.6

2 files

7.5.1

2 files

7.5

2 files

7.4.2

2 files

7.4.1

2 files

Yanked

7.4

2 files

Yanked reason: Broken release, use 7.4.1

7.3.2

2 files

7.3.1

2 files

7.3

2 files

7.2.1

2 files

7.2

2 files

7.1

2 files

7.0

2 files

6.1.3

2 files

6.1.2

2 files

6.1.1

2 files

6.1

2 files

6.0

1 file

5.5

2 files

5.4

2 files

5.3.3

2 files

5.3.2

2 files

5.3.1

2 files

5.3

2 files

5.2

2 files

5.1.1

2 files

5.1

2 files

5.0

2 files

4.6.2

2 files

4.6.1

2 files

4.6

2 files

4.5

2 files

4.4

2 files

4.3

2 files

4.2

2 files

4.1

2 files

4.0

2 files

3.4.1

2 files

3.4

3.3

1 file

3.2

1 file

3.1.1

1 file

3.1

1 file

3.0.2

1 file

3.0.1

1 file

3.0

1 file

2.1.2

1 file

2.1.1

1 file

2.1

1 file

2.0

1 file

1.5

1 file

1.4

1 file

1.3

1 file

1.2

1 file

1.1.2

1 file

1.1.1

1 file

1.1

1 file

1.0.7

1 file

1.0.6.1

1 file

1.0.6

1 file

1.0.5

1 file

1.0.4

1 file

1.0.3

1 file

1.0.2

1 file

1.0.1

1 file

1.0

1 file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page