# Django Countries
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](https://smileychris.github.io/django-countries/)**
## Quick Start
Install:
```bash
pip install django-countries
```
Add to `INSTALLED_APPS`:
```python
INSTALLED_APPS = [
# ...
'django_countries',
]
```
Use in your models:
```python
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
- **Django REST Framework**: 3.14+
## Contributing
Contributions are welcome! See the [Contributing Guide](https://smileychris.github.io/django-countries/contributing/) for details.
## Translations
Country names are translated using Django's standard `gettext` and imported from our [Transifex project](https://explore.transifex.com/smileychris/django-countries/).