ISO Country Codes Explained: Alpha-2, Alpha-3, Numeric

Two letters stand for a country on almost every form you fill in, yet many developers only learn the rules behind them after a bug. Why is Germany DE? Why do some systems want three letters instead of two? And how does a pair of letters turn into a flag emoji? This guide explains the ISO 3166 family of country codes, how they are used in software and the mistakes worth avoiding.

Three codes for every country

The international standard ISO 3166-1 gives each country or territory three codes:

• Alpha-2 — two letters, the most widely used: US, DE, JP.
• Alpha-3 — three letters, easier to recognize at a glance: USA, DEU, JPN.
• Numeric — three digits, independent of any alphabet: 840, 276, 392.

Alpha-2 is the default for web forms, shipping and payments. Alpha-3 appears in some passports and sports results, while numeric codes are handy when letters could cause confusion across writing systems.

Why some codes look strange

Codes are often based on a country’s own name rather than its English one:

• DE — Germany, from Deutschland.
• ES — Spain, from España.
• CH — Switzerland, from the Latin Confoederatio Helvetica.
• HR — Croatia, from Hrvatska.
• ZA — South Africa, from the Dutch Zuid-Afrika.

Codes also change with history. When a country dissolves or renames itself, codes are retired or replaced — Czechoslovakia’s CS and the Soviet Union’s SU are no longer active, which is why old databases sometimes contain codes that modern validators reject.

Domains, flags and subdivisions

Country-code internet domains mostly follow alpha-2: .de, .jp, .br. The best-known exception is the United Kingdom, which uses .uk even though its ISO code is GB.

Flag emoji are built from the same codes. Unicode defines 26 “regional indicator” letters, and a supporting device shows the right flag when two of them appear together, so the letters F and R become the French flag. Some systems show only the letters, which is why flags look different across platforms.

For regions inside a country there is ISO 3166-2, which adds a suffix to the alpha-2 code: US-CA for California or CA-ON for Ontario.

Generate country codes with RandNow

The Random Country Code Generator above is a quick source of realistic values:

1. Enter a number from 1 to 100 in How many?.
2. Press Generate. Each result shows the flag, the code and the country name, for example 🇷🇴 RO (Romania).
3. Copy the list or export it as CSV, JSON or TXT for fixtures, dropdown mockups or a geography quiz.

Each pick is independent, so a large batch can repeat a code. Everything runs in your browser with the Web Crypto API and nothing is stored. To see full country names first, try:

Pitfalls developers should avoid

• Case: store codes in uppercase and normalize input, because “de” and “DE” should match.
• Language versus country: en is a language code; GB or US are countries. Locales such as en-GB combine both.
• Hard-coded lists: codes are added and retired over time, so keep your list updatable.
• Special cases: Kosovo is commonly represented by XK, a code from the user-assigned range rather than an official ISO assignment. Decide how your system handles it.
• Display names: store the code, not the name, and translate names for each user’s language.

Other country codes you will meet

ISO codes are not the only country abbreviations in daily life, and mixing them up is a classic error:

• Sports codes: the Olympic movement uses its own three-letter codes, such as GER for Germany and SUI for Switzerland, instead of the ISO alpha-3 DEU and CHE.
• Vehicle stickers: international vehicle registration codes differ again — Germany is simply D.
• Currency codes: ISO 4217 currency codes often begin with the country’s alpha-2 code, as in JPY or CHF, but they are a separate standard.

When a spreadsheet arrives with a “country” column, check which system it uses before importing it.

Pro tips

• Use alpha-2 as your internal key unless a partner system demands alpha-3.
• Validate against a maintained list rather than a pattern like two capital letters.
• Test flag display on several devices, since some show letters instead of flags.
• Quiz yourself on codes that do not match the English name, such as DE, ES and CH.

Frequently asked questions