Codes
Codes are lowercase. ISO 3166-1 alpha-2 codes are the same as in flag-icons and in most APIs (uppercase them for Intl or ISO data). Use toPennantCode to normalize user input.
js
import { codes, isoCodes, isPennantCode, toPennantCode } from 'pennants';
codes.length; // 271
isoCodes.length; // 249
isPennantCode('ar'); // true; exact lowercase match
toPennantCode(' GB-ENG '); // 'gb-eng'; throws RangeError for unknown codesNames below come from getPennantName(code, 'en'). The gallery has search and snippets.
Regions and organizations
| Flag | Code | Name | Emoji |
|---|---|---|---|
 | arab | League of Arab States | — |
 | asean | Association of Southeast Asian Nations | — |
 | cefta | Central European Free Trade Agreement | — |
 | cp | Clipperton Island | — |
 | dg | Diego Garcia | — |
 | eac | East African Community | — |
 | es-ct | Catalonia | — |
 | es-ga | Galicia | — |
 | es-pv | Basque Country | — |
 | eu | European Union | 🇪🇺 |
 | gb-eng | England | — |
 | gb-nir | Northern Ireland | — |
 | gb-sct | Scotland | — |
 | gb-wls | Wales | — |
 | ic | Canary Islands | — |
 | pc | Pacific Community | — |
 | sh-ac | Ascension Island | — |
 | sh-hl | Saint Helena | — |
 | sh-ta | Tristan da Cunha | — |
 | un | United Nations | 🇺🇳 |
 | xk | Kosovo | — |
 | xx | Unknown | — |
ISO 3166-1 countries and territories
| Flag | Code | Name | Emoji |
|---|---|---|---|
 | ad | Andorra | 🇦🇩 |
 | ae | United Arab Emirates | 🇦🇪 |
 | af | Afghanistan | 🇦🇫 |
 | ag | Antigua & Barbuda | 🇦🇬 |
 | ai | Anguilla | 🇦🇮 |
 | al | Albania | 🇦🇱 |
 | am | Armenia | 🇦🇲 |
 | ao | Angola | 🇦🇴 |
 | aq | Antarctica | 🇦🇶 |
 | ar | Argentina | 🇦🇷 |
 | as | American Samoa | 🇦🇸 |
 | at | Austria | 🇦🇹 |
 | au | Australia | 🇦🇺 |
 | aw | Aruba | 🇦🇼 |
 | ax | Åland Islands | 🇦🇽 |
 | az | Azerbaijan | 🇦🇿 |
 | ba | Bosnia & Herzegovina | 🇧🇦 |
 | bb | Barbados | 🇧🇧 |
 | bd | Bangladesh | 🇧🇩 |
 | be | Belgium | 🇧🇪 |
 | bf | Burkina Faso | 🇧🇫 |
 | bg | Bulgaria | 🇧🇬 |
 | bh | Bahrain | 🇧🇭 |
 | bi | Burundi | 🇧🇮 |
 | bj | Benin | 🇧🇯 |
 | bl | St. Barthélemy | 🇧🇱 |
 | bm | Bermuda | 🇧🇲 |
 | bn | Brunei | 🇧🇳 |
 | bo | Bolivia | 🇧🇴 |
 | bq | Caribbean Netherlands | 🇧🇶 |
 | br | Brazil | 🇧🇷 |
 | bs | Bahamas | 🇧🇸 |
 | bt | Bhutan | 🇧🇹 |
 | bv | Bouvet Island | 🇧🇻 |
 | bw | Botswana | 🇧🇼 |
 | by | Belarus | 🇧🇾 |
 | bz | Belize | 🇧🇿 |
 | ca | Canada | 🇨🇦 |
 | cc | Cocos (Keeling) Islands | 🇨🇨 |
 | cd | Congo - Kinshasa | 🇨🇩 |
 | cf | Central African Republic | 🇨🇫 |
 | cg | Congo - Brazzaville | 🇨🇬 |
 | ch | Switzerland | 🇨🇭 |
 | ci | Côte d’Ivoire | 🇨🇮 |
 | ck | Cook Islands | 🇨🇰 |
 | cl | Chile | 🇨🇱 |
 | cm | Cameroon | 🇨🇲 |
 | cn | China | 🇨🇳 |
 | co | Colombia | 🇨🇴 |
 | cr | Costa Rica | 🇨🇷 |
 | cu | Cuba | 🇨🇺 |
 | cv | Cape Verde | 🇨🇻 |
 | cw | Curaçao | 🇨🇼 |
 | cx | Christmas Island | 🇨🇽 |
 | cy | Cyprus | 🇨🇾 |
 | cz | Czechia | 🇨🇿 |
 | de | Germany | 🇩🇪 |
 | dj | Djibouti | 🇩🇯 |
 | dk | Denmark | 🇩🇰 |
 | dm | Dominica | 🇩🇲 |
 | do | Dominican Republic | 🇩🇴 |
 | dz | Algeria | 🇩🇿 |
 | ec | Ecuador | 🇪🇨 |
 | ee | Estonia | 🇪🇪 |
 | eg | Egypt | 🇪🇬 |
 | eh | Western Sahara | 🇪🇭 |
 | er | Eritrea | 🇪🇷 |
 | es | Spain | 🇪🇸 |
 | et | Ethiopia | 🇪🇹 |
 | fi | Finland | 🇫🇮 |
 | fj | Fiji | 🇫🇯 |
 | fk | Falkland Islands | 🇫🇰 |
 | fm | Micronesia | 🇫🇲 |
 | fo | Faroe Islands | 🇫🇴 |
 | fr | France | 🇫🇷 |
 | ga | Gabon | 🇬🇦 |
 | gb | United Kingdom | 🇬🇧 |
 | gd | Grenada | 🇬🇩 |
 | ge | Georgia | 🇬🇪 |
 | gf | French Guiana | 🇬🇫 |
 | gg | Guernsey | 🇬🇬 |
 | gh | Ghana | 🇬🇭 |
 | gi | Gibraltar | 🇬🇮 |
 | gl | Greenland | 🇬🇱 |
 | gm | Gambia | 🇬🇲 |
 | gn | Guinea | 🇬🇳 |
 | gp | Guadeloupe | 🇬🇵 |
 | gq | Equatorial Guinea | 🇬🇶 |
 | gr | Greece | 🇬🇷 |
 | gs | South Georgia & South Sandwich Islands | 🇬🇸 |
 | gt | Guatemala | 🇬🇹 |
 | gu | Guam | 🇬🇺 |
 | gw | Guinea-Bissau | 🇬🇼 |
 | gy | Guyana | 🇬🇾 |
 | hk | Hong Kong SAR China | 🇭🇰 |
 | hm | Heard & McDonald Islands | 🇭🇲 |
 | hn | Honduras | 🇭🇳 |
 | hr | Croatia | 🇭🇷 |
 | ht | Haiti | 🇭🇹 |
 | hu | Hungary | 🇭🇺 |
 | id | Indonesia | 🇮🇩 |
 | ie | Ireland | 🇮🇪 |
 | il | Israel | 🇮🇱 |
 | im | Isle of Man | 🇮🇲 |
 | in | India | 🇮🇳 |
 | io | British Indian Ocean Territory | 🇮🇴 |
 | iq | Iraq | 🇮🇶 |
 | ir | Iran | 🇮🇷 |
 | is | Iceland | 🇮🇸 |
 | it | Italy | 🇮🇹 |
 | je | Jersey | 🇯🇪 |
 | jm | Jamaica | 🇯🇲 |
 | jo | Jordan | 🇯🇴 |
 | jp | Japan | 🇯🇵 |
 | ke | Kenya | 🇰🇪 |
 | kg | Kyrgyzstan | 🇰🇬 |
 | kh | Cambodia | 🇰🇭 |
 | ki | Kiribati | 🇰🇮 |
 | km | Comoros | 🇰🇲 |
 | kn | St. Kitts & Nevis | 🇰🇳 |
 | kp | North Korea | 🇰🇵 |
 | kr | South Korea | 🇰🇷 |
 | kw | Kuwait | 🇰🇼 |
 | ky | Cayman Islands | 🇰🇾 |
 | kz | Kazakhstan | 🇰🇿 |
 | la | Laos | 🇱🇦 |
 | lb | Lebanon | 🇱🇧 |
 | lc | St. Lucia | 🇱🇨 |
 | li | Liechtenstein | 🇱🇮 |
 | lk | Sri Lanka | 🇱🇰 |
 | lr | Liberia | 🇱🇷 |
 | ls | Lesotho | 🇱🇸 |
 | lt | Lithuania | 🇱🇹 |
 | lu | Luxembourg | 🇱🇺 |
 | lv | Latvia | 🇱🇻 |
 | ly | Libya | 🇱🇾 |
 | ma | Morocco | 🇲🇦 |
 | mc | Monaco | 🇲🇨 |
 | md | Moldova | 🇲🇩 |
 | me | Montenegro | 🇲🇪 |
 | mf | St. Martin | 🇲🇫 |
 | mg | Madagascar | 🇲🇬 |
 | mh | Marshall Islands | 🇲🇭 |
 | mk | North Macedonia | 🇲🇰 |
 | ml | Mali | 🇲🇱 |
 | mm | Myanmar (Burma) | 🇲🇲 |
 | mn | Mongolia | 🇲🇳 |
 | mo | Macao SAR China | 🇲🇴 |
 | mp | Northern Mariana Islands | 🇲🇵 |
 | mq | Martinique | 🇲🇶 |
 | mr | Mauritania | 🇲🇷 |
 | ms | Montserrat | 🇲🇸 |
 | mt | Malta | 🇲🇹 |
 | mu | Mauritius | 🇲🇺 |
 | mv | Maldives | 🇲🇻 |
 | mw | Malawi | 🇲🇼 |
 | mx | Mexico | 🇲🇽 |
 | my | Malaysia | 🇲🇾 |
 | mz | Mozambique | 🇲🇿 |
 | na | Namibia | 🇳🇦 |
 | nc | New Caledonia | 🇳🇨 |
 | ne | Niger | 🇳🇪 |
 | nf | Norfolk Island | 🇳🇫 |
 | ng | Nigeria | 🇳🇬 |
 | ni | Nicaragua | 🇳🇮 |
 | nl | Netherlands | 🇳🇱 |
 | no | Norway | 🇳🇴 |
 | np | Nepal | 🇳🇵 |
 | nr | Nauru | 🇳🇷 |
 | nu | Niue | 🇳🇺 |
 | nz | New Zealand | 🇳🇿 |
 | om | Oman | 🇴🇲 |
 | pa | Panama | 🇵🇦 |
 | pe | Peru | 🇵🇪 |
 | pf | French Polynesia | 🇵🇫 |
 | pg | Papua New Guinea | 🇵🇬 |
 | ph | Philippines | 🇵🇭 |
 | pk | Pakistan | 🇵🇰 |
 | pl | Poland | 🇵🇱 |
 | pm | St. Pierre & Miquelon | 🇵🇲 |
 | pn | Pitcairn Islands | 🇵🇳 |
 | pr | Puerto Rico | 🇵🇷 |
 | ps | Palestinian Territories | 🇵🇸 |
 | pt | Portugal | 🇵🇹 |
 | pw | Palau | 🇵🇼 |
 | py | Paraguay | 🇵🇾 |
 | qa | Qatar | 🇶🇦 |
 | re | Réunion | 🇷🇪 |
 | ro | Romania | 🇷🇴 |
 | rs | Serbia | 🇷🇸 |
 | ru | Russia | 🇷🇺 |
 | rw | Rwanda | 🇷🇼 |
 | sa | Saudi Arabia | 🇸🇦 |
 | sb | Solomon Islands | 🇸🇧 |
 | sc | Seychelles | 🇸🇨 |
 | sd | Sudan | 🇸🇩 |
 | se | Sweden | 🇸🇪 |
 | sg | Singapore | 🇸🇬 |
 | sh | St. Helena | 🇸🇭 |
 | si | Slovenia | 🇸🇮 |
 | sj | Svalbard & Jan Mayen | 🇸🇯 |
 | sk | Slovakia | 🇸🇰 |
 | sl | Sierra Leone | 🇸🇱 |
 | sm | San Marino | 🇸🇲 |
 | sn | Senegal | 🇸🇳 |
 | so | Somalia | 🇸🇴 |
 | sr | Suriname | 🇸🇷 |
 | ss | South Sudan | 🇸🇸 |
 | st | São Tomé & Príncipe | 🇸🇹 |
 | sv | El Salvador | 🇸🇻 |
 | sx | Sint Maarten | 🇸🇽 |
 | sy | Syria | 🇸🇾 |
 | sz | Eswatini | 🇸🇿 |
 | tc | Turks & Caicos Islands | 🇹🇨 |
 | td | Chad | 🇹🇩 |
 | tf | French Southern Territories | 🇹🇫 |
 | tg | Togo | 🇹🇬 |
 | th | Thailand | 🇹🇭 |
 | tj | Tajikistan | 🇹🇯 |
 | tk | Tokelau | 🇹🇰 |
 | tl | Timor-Leste | 🇹🇱 |
 | tm | Turkmenistan | 🇹🇲 |
 | tn | Tunisia | 🇹🇳 |
 | to | Tonga | 🇹🇴 |
 | tr | Türkiye | 🇹🇷 |
 | tt | Trinidad & Tobago | 🇹🇹 |
 | tv | Tuvalu | 🇹🇻 |
 | tw | Taiwan | 🇹🇼 |
 | tz | Tanzania | 🇹🇿 |
 | ua | Ukraine | 🇺🇦 |
 | ug | Uganda | 🇺🇬 |
 | um | U.S. Outlying Islands | 🇺🇲 |
 | us | United States | 🇺🇸 |
 | uy | Uruguay | 🇺🇾 |
 | uz | Uzbekistan | 🇺🇿 |
 | va | Vatican City | 🇻🇦 |
 | vc | St. Vincent & Grenadines | 🇻🇨 |
 | ve | Venezuela | 🇻🇪 |
 | vg | British Virgin Islands | 🇻🇬 |
 | vi | U.S. Virgin Islands | 🇻🇮 |
 | vn | Vietnam | 🇻🇳 |
 | vu | Vanuatu | 🇻🇺 |
 | wf | Wallis & Futuna | 🇼🇫 |
 | ws | Samoa | 🇼🇸 |
 | ye | Yemen | 🇾🇪 |
 | yt | Mayotte | 🇾🇹 |
 | za | South Africa | 🇿🇦 |
 | zm | Zambia | 🇿🇲 |
 | zw | Zimbabwe | 🇿🇼 |