---
id: country-list
version: "1.1.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# country_list — List of all countries with names and ISO 3166-1 codes in all languages

License: permissive · Maintenance: active · Downloads: 84.4K/mo

## What it is and what it does

country_list is a lightweight reference package that bundles ISO 3166-1 country codes alongside country names translated into multiple languages. It exposes a simple API to query countries by language code, returning code-name pairs, and to reverse-lookup country codes from names. The package has no runtime dependencies and supports Python 3.8 through 3.12.

Typical use is in web forms, data validation, or internationalization workflows where you need to populate dropdowns or validate user input against a canonical list of countries. The data comes from umpirsky/country-list and is packaged as a pure Python wheel, making it quick to install and integrate.

Use it for:

- Populate country dropdown menus in web forms with localized country names for different user languages.
- Validate user-entered country names or codes against the ISO 3166-1 standard during data import or form submission.
- Build a reverse lookup table to convert country names (in any supported language) back to ISO codes for storage or API calls.
- Generate multilingual country reference data for documentation, reports, or configuration files.
- Support internationalization by serving country lists in the user's preferred language without maintaining separate data files.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides ISO 3166-1 country codes and names in multiple languages, queryable by language or country code.

Yes. The package is lightweight, has zero dependencies, is actively maintained, carries a permissive MIT license, and solves a common reference-data problem. Install it if you need ISO 3166-1 country codes and names in multiple languages; skip it only if you already have country data embedded elsewhere or need real-time updates beyond what a static package provides.

## Install

pip install country-list
uv add country-list
poetry add country-list

## Installing country_list

Before you install: Low install friction with no runtime dependencies. Actively maintained with recent commits; last release was 1013 days ago but repo shows activity through 2026-08-07.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions—suitable for commercial and open-source projects.

Quickstart:

pip install country_list

from country_list import countries_for_language
countries = dict(countries_for_language('en'))
print(countries['GB'])  # 'United Kingdom'

Verify before relying:

- Whether all language codes and country names are current with ISO 3166-1 standard updates
- Performance characteristics when working with the full dataset across all supported languages

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 84.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

country codes and names, ISO 3166-1 lookup, multilingual country data, country name to code mapping, international country list, country data by language, reference-data, i18n, iso-standards

[View on SkillFed](https://skillfed.io/packages/country-list) · [View on PyPI](https://pypi.org/project/country-list/)