Tag Archive for: e-commerce

Posts

WooCommerce Country Codes: Essential Guide for E-commerce Stores

26/09/2025/in Blog

If you’re running an online store with WooCommerce, you’ve probably encountered country codes. But what exactly are they? Simply put, a country code is a short, standardised abbreviation (usually two letters) that represents a specific country, like US for the United States or GB for Great Britain. WooCommerce uses these codes behind the scenes to identify where your customers are from, which helps it calculate shipping costs, taxes, and even the checkout options that appear during a purchase. These country codes make it easier for your store to handle international orders smoothly without confusion or errors.

WooCommerce is one of the leading e-commerce platforms, loved for its flexibility and powerful features that support selling worldwide. Thanks to the use of country codes, it lets you set up shipping zones, tax rules, and payment methods tailored precisely to different countries and regions. This means you can offer your customers accurate prices and shipping times no matter where they live.

Alongside country codes, WooCommerce also uses state or region codes, which work the same way but at a more detailed level. For example, in the US or Canada, different states or provinces may have different tax rates or shipping rules, and these codes help WooCommerce handle those details properly.

In this guide, you’ll learn everything about WooCommerce country codes: what they are, how to use them, and why they’re so important for running a smooth, professional online store that sells internationally.

What Are WooCommerce Country Codes?

When managing an online store with WooCommerce, country codes play an essential role in organising your sales and shipping across different countries. At their core, country codes are short, standardised abbreviations that represent countries worldwide. WooCommerce uses the internationally recognised ISO 3166-1 alpha-2 standard for these codes, which consists of two capital letters—such as GB for the United Kingdom, FR for France, and DE for Germany.

These codes are more than just labels. WooCommerce relies on them internally to:

Identify the country of a customer during checkout
Apply the correct shipping zones and rates based on location
Calculate taxes accurately according to local laws
Tailor payment gateways and currency options for specific countries

Understanding the difference between country codes and state codes is also important. While country codes represent entire nations, state codes (or region codes) refer to subdivisions within those countries. For example, in the United States, US is the country code, while CA stands for California, a state within the US. Similarly, in Canada, CA is the country code, and ON is the code for Ontario. WooCommerce uses both to allow store owners to set precise shipping rules or tax rates that may differ between states, provinces, or regions.

Why Accurate Country Codes Matter

Using accurate country codes is crucial for your store’s smooth operation and customer satisfaction. Here’s why:

Shipping Precision: Shipping costs and options often vary from country to country. Correct codes ensure customers see only the relevant shipping methods and prices.
Tax Compliance: Different countries—and even regions within countries—have distinct tax laws. Accurate codes help your store apply the right tax rates, avoiding legal complications.
Improved User Experience: When country codes are correctly set, customers get tailored checkout options like preferred currencies or local payment gateways, making purchases faster and easier.
Avoid Order Errors: Mistakes in country codes can lead to failed orders, incorrect shipping, or delays, which harm your reputation and increase costs.

In short, country codes are the backbone of WooCommerce’s international functionality. Ensuring they are set up properly helps you manage your global store efficiently, keeps customers happy, and keeps your business compliant with different country regulations.

List of Supported WooCommerce Country Codes

WooCommerce supports a comprehensive set of country codes based on the ISO 3166-1 alpha-2 standard. These two-letter codes allow WooCommerce to precisely identify countries for shipping, taxes, and checkout processes. Having a clear, up-to-date list of supported country codes is essential for store owners, especially those selling internationally.

Below is an alphabetised table of WooCommerce-supported country codes and their corresponding countries. This list forms the basis for WooCommerce’s shipping zones, tax calculations, and more.

Country Code	Country Name	Country Code	Country Name
AE	United Arab Emirates	MD	Moldova
AF	Afghanistan	ME	Montenegro
AG	Antigua and Barbuda	MG	Madagascar
AI	Anguilla	MK	North Macedonia
AL	Albania	ML	Mali
AM	Armenia	MM	Myanmar
AO	Angola	MN	Mongolia
AR	Argentina	MO	Macau
AS	American Samoa	MR	Mauritania
AT	Austria	MS	Montserrat
AU	Australia	MT	Malta
AW	Aruba	MU	Mauritius
AX	Åland Islands	MV	Maldives
AZ	Azerbaijan	MW	Malawi
BA	Bosnia and Herzegovina	MX	Mexico
BB	Barbados	MY	Malaysia
BD	Bangladesh	MZ	Mozambique
BE	Belgium	NA	Namibia
BF	Burkina Faso	NC	New Caledonia
BG	Bulgaria	NE	Niger
BH	Bahrain	NF	Norfolk Island
BI	Burundi	NG	Nigeria
BJ	Benin	NI	Nicaragua
BL	Saint Barthélemy	NL	Netherlands
BM	Bermuda	NO	Norway
BN	Brunei	NP	Nepal
BO	Bolivia	NR	Nauru
BQ	Bonaire, Sint Eustatius, and Saba	NU	Niue
BR	Brazil	NZ	New Zealand
BS	Bahamas	OM	Oman
BT	Bhutan	PA	Panama
BV	Bouvet Island	PE	Peru
BW	Botswana	PF	French Polynesia
BY	Belarus	PG	Papua New Guinea
BZ	Belize	PH	Philippines
CA	Canada	PK	Pakistan
CC	Cocos (Keeling) Islands	PL	Poland
CD	Democratic Republic of the Congo	PM	Saint Pierre and Miquelon
CF	Central African Republic	PN	Pitcairn Islands
CG	Republic of the Congo	PR	Puerto Rico
CH	Switzerland	PS	Palestinian Territories
CI	Côte d’Ivoire	PT	Portugal
CK	Cook Islands	PW	Palau
CL	Chile	PY	Paraguay
CM	Cameroon	QA	Qatar
CN	China	RE	Réunion
CO	Colombia	RO	Romania
CR	Costa Rica	RS	Serbia
CU	Cuba	RU	Russia
CV	Cape Verde	RW	Rwanda
CW	Curaçao	SA	Saudi Arabia
CX	Christmas Island	SB	Solomon Islands
CY	Cyprus	SC	Seychelles
CZ	Czech Republic	SD	Sudan
DE	Germany	SE	Sweden
DJ	Djibouti	SG	Singapore
DK	Denmark	SH	Saint Helena
DM	Dominica	SI	Slovenia
DO	Dominican Republic	SJ	Svalbard and Jan Mayen
DZ	Algeria	SK	Slovakia
EC	Ecuador	SL	Sierra Leone
EE	Estonia	SM	San Marino
EG	Egypt	SN	Senegal
EH	Western Sahara	SO	Somalia
ER	Eritrea	SR	Suriname
ES	Spain	SS	South Sudan
ET	Ethiopia	ST	São Tomé and Príncipe
FI	Finland	SV	El Salvador
FJ	Fiji	SX	Sint Maarten
FM	Micronesia	SY	Syria
FO	Faroe Islands	SZ	Eswatini
FR	France	TC	Turks and Caicos Islands
GA	Gabon	TD	Chad
GB	United Kingdom	TF	French Southern Territories
GD	Grenada	TG	Togo
GE	Georgia	TH	Thailand
GF	French Guiana	TJ	Tajikistan
GG	Guernsey	TK	Tokelau
GH	Ghana	TL	Timor-Leste
GI	Gibraltar	TM	Turkmenistan
GL	Greenland	TN	Tunisia
GM	Gambia	TO	Tonga
GN	Guinea	TR	Turkey
GP	Guadeloupe	TT	Trinidad and Tobago
GQ	Equatorial Guinea	TV	Tuvalu
GR	Greece	TZ	Tanzania
GT	Guatemala	UA	Ukraine
GU	Guam	UG	Uganda
GW	Guinea-Bissau	UM	United States Minor Outlying Islands
GY	Guyana	US	United States
HK	Hong Kong	UY	Uruguay
HM	Heard Island and McDonald Islands	UZ	Uzbekistan
HN	Honduras	VA	Vatican City
HR	Croatia	VC	Saint Vincent and the Grenadines
HT	Haiti	VE	Venezuela
HU	Hungary	VG	British Virgin Islands
ID	Indonesia	VI	U.S. Virgin Islands
IE	Ireland	VN	Vietnam
IL	Israel	VU	Vanuatu
IM	Isle of Man	WF	Wallis and Futuna
IN	India	WS	Samoa
IO	British Indian Ocean Territory	XK	Kosovo
IQ	Iraq	YE	Yemen
IR	Iran	YT	Mayotte
IS	Iceland	ZA	South Africa
IT	Italy	ZM	Zambia
JE	Jersey	ZW	Zimbabwe
JM	Jamaica

How Is This List Maintained and Updated?

WooCommerce regularly updates its country code list to stay aligned with the official ISO 3166-1 alpha-2 standard maintained by the International Organization for Standardization (ISO). Changes can happen if countries rename, merge, split, or new territories are recognised. WooCommerce reflects these updates in their codebase through periodic software updates and patches.

For store owners, this means that keeping WooCommerce up to date will usually ensure your country code list remains current without manual intervention.

How to Access This List Within WooCommerce

If you want to see or work directly with the list of country codes WooCommerce supports, you can access it in several ways:

Within WooCommerce Plugin Files: The country codes are stored in a PHP file called countries.php inside the WooCommerce plugin folder (typically found at woocommerce/i18n/countries.php). This file contains an array mapping country codes to country names.
Through WooCommerce Settings: In your WordPress admin dashboard, go to WooCommerce > Settings > General > Selling Locations or Shipping Zones. When configuring shipping or tax zones, WooCommerce uses this country code list internally to let you choose which countries or regions you want to target.

Programmatically: If you are developing custom code or plugins, WooCommerce provides functions to retrieve the country list, such as:

php
CopyEdit
WC()->countries->get_countries();

This returns an array of all supported countries and their codes.

WooCommerce State Codes and Their Importance

Just as WooCommerce uses country codes to identify nations, it also relies on state codes to represent subdivisions within those countries—such as states, provinces, regions, or territories. These codes follow the ISO 3166-2 standard, which defines codes for the principal subdivisions of all countries coded in ISO 3166-1.

State codes are crucial in WooCommerce for several reasons:

Shipping: Many shipping methods and carriers calculate rates based on specific states or provinces rather than just countries. State codes let WooCommerce assign shipping zones more precisely.
Tax Calculations: Tax rates often differ between regions within the same country. For example, sales tax in California differs from Texas. WooCommerce uses state codes to apply accurate tax rules.
Checkout and Billing: Correct state codes ensure customers see appropriate options and avoid confusion during checkout.
Legal Compliance: Some regulations require storing location data at a regional level, making state codes essential.

Because these subdivisions vary widely across countries, WooCommerce allows you to customise or add state codes based on your target markets.

List of WooCommerce State Codes:-

Albanian (AL) states

Code	State	Code	State	Code	State
AL-01	Berat	AL-02	Durrës	AL-03	Elbasan
AL-04	Fier	AL-05	Gjirokastër	AL-06	Korçë
AL-07	Kukës	AL-08	Lezhë	AL-09	Dibër
AL-10	Shkodër	AL-11	Tirana	AL-12	Vlorë

Angolan (AO) States

Code	State	Code	State	Code	State
BGO	Bengo	BLU	Benguela	BIE	Bié
CAB	Cabinda	CNN	Cunene	HUA	Huambo
HUI	Huíla	CCU	Kuando Kubango	CNO	Kwanza-Norte
CUS	Kwanza-Sul	LUA	Luanda	LNO	Lunda-Norte
LSU	Lunda-Sul	MAL	Malanje	MOX	Moxico
NAM	Namibe	UIG	Uíge	ZAI	Zaire

Argentinian (AR) Provinces

Code	State	Code	State	Code	State
C	Ciudad Autónoma de Buenos Aires	B	Buenos Aires	K	Catamarca
H	Chaco	U	Chubut	X	Córdoba
W	Corrientes	E	Entre Ríos	P	Formosa
Y	Jujuy	L	La Pampa	F	La Rioja
M	Mendoza	N	Misiones	Q	Neuquén
R	Río Negro	A	Salta	J	San Juan
D	San Luis	Z	Santa Cruz	S	Santa Fe
G	Santiago del Estero	V	Tierra del Fuego	T	Tucumán

Australian (AU) States

Code	State	Code	State
ACT	Australian Capital Territory	NSW	New South Wales
NT	Northern Territory	QLD	Queensland
SA	South Australia	TAS	Tasmania
VIC	Victoria	WA	Western Australia

Bangladeshi (BD) Districts

Code	State	Code	State	Code	State
BD-05	Bagerhat	BD-01	Bandarban	BD-02	Barguna
BD-06	Barishal	BD-07	Bhola	BD-03	Bogura
BD-04	Brahmanbaria	BD-09	Chandpur	BD-10	Chattogram
BD-12	Chuadanga	BD-11	Cox’s Bazar	BD-08	Cumilla
BD-13	Dhaka	BD-14	Dinajpur	BD-15	Faridpur
BD-16	Feni	BD-19	Gaibandha	BD-18	Gazipur
BD-17	Gopalganj	BD-20	Habiganj	BD-21	Jamalpur
BD-22	Jashore	BD-25	Jhalokati	BD-23	Jhenaidah
BD-24	Joypurhat	BD-29	Khagrachhari	BD-27	Khulna
BD-26	Kishoreganj	BD-28	Kurigram	BD-30	Kushtia
BD-31	Lakshmipur	BD-32	Lalmonirhat	BD-36	Madaripur
BD-37	Magura	BD-33	Manikganj	BD-39	Meherpur
BD-38	Moulvibazar	BD-35	Munshiganj	BD-34	Mymensingh
BD-48	Naogaon	BD-43	Narail	BD-40	Narayanganj
BD-42	Narsingdi	BD-44	Natore	BD-45	Nawabganj
BD-41	Netrakona	BD-46	Nilphamari	BD-47	Noakhali
BD-49	Pabna	BD-52	Panchagarh	BD-51	Patuakhali
BD-50	Pirojpur	BD-53	Rajbari	BD-54	Rajshahi
BD-56	Rangamati	BD-55	Rangpur	BD-58	Satkhira
BD-62	Shariatpur	BD-57	Sherpur	BD-59	Sirajganj
BD-61	Sunamganj	BD-60	Sylhet	BD-63	Tangail
BD-64	Thakurgaon

Bulgarian (BG) States

Code	State	Code	State	Code	State
BG-01	Blagoevgrad	BG-02	Burga	BG-08	Dobrich
BG-07	Gabrovo	BG-26	Haskovo	BG-09	Kardzhali
BG-10	Kyustendil	BG-11	Lovech	BG-12	Montana
BG-13	Pazardzhik	BG-14	Pernik	BG-15	Pleven
BG-16	Plovdiv	BG-17	Razgrad	BG-18	Ruse
BG-27	Shumen	BG-19	Silistra	BG-20	Sliven
BG-21	Smolyan	BG-23	Sofia	BG-22	Sofia-Grad
BG-24	Stara Zagora	BG-25	Targovishte	BG-03	Varna
BG-04	Veliko Tarnovo	BG-05	Vidin	BG-06	Vratsa
BG-28	Yambol

Beninese (BJ) States

Code	State	Code	State	Code	State
AL	Alibori	AK	Atakora	AQ	Atlantique
BO	Borgou	CO	Collines	KO	Kouffo
DO	Donga	LI	Littoral	MO	Mono
OU	Ouémé	PL	Plateau	ZO	Zou

Bolivian (BO) States

Code	State	Code	State	Code	State
BO-B	Beni	BO-H	Chuquisaca	BO-C	Cochabamba
BO-L	La Paz	BO-O	Oruro	BO-N	Pando
BO-P	Potosí	BO-S	Santa Cruz	BO-T	Tarija

Brazilian (BR) States

Code	State	Code	State	Code	State
AC	Acre	AL	Alagoas	AP	Amapá
AM	Amazonas	BA	Bahia	CE	Ceará
DF	Distrito Federal	ES	Espírito Santo	GO	Goiás
MA	Maranhão	MT	Mato Grosso	MS	Mato Grosso do Sul
MG	Minas Gerais	PA	Pará	PB	Paraíba
PR	Paraná	PE	Pernambuco	PI	Piauí
RJ	Rio de Janeiro	RN	Rio Grande do Norte	RS	Rio Grande do Sul
RO	Rondônia	RR	Roraima	SC	Santa Catarina
SP	São Paulo	SE	Sergipe	TO	Tocantins

Canadian (CA) Provinces and Territories

Code	Province/Territory	Code	Province/Territory	Code	Province/Territory
AB	Alberta	BC	British Columbia	MB	Manitoba
NB	New Brunswick	NL	Newfoundland and Labrador	NT	Northwest Territories
NS	Nova Scotia	NU	Nunavut	ON	Ontario
PE	Prince Edward Island	QC	Quebec	SK	Saskatchewan
YT	Yukon Territory

Algerian (DZ) States

Code	State	Code	State	Code	State
DZ-01	Adrar	DZ-02	Chlef	DZ-03	Laghouat
DZ-04	Oum El Bouaghi	DZ-05	Batna	DZ-06	Béjaïa
DZ-07	Biskra	DZ-08	Béchar	DZ-09	Blida
DZ-10	Bouira	DZ-11	Tamanghasset	DZ-12	Tébessa
DZ-13	Tlemcen	DZ-14	Tiaret	DZ-15	Tizi Ouzou
DZ-16	Algiers	DZ-17	Djelfa	DZ-18	Jijel
DZ-19	Sétif	DZ-20	Saïda	DZ-21	Skikda
DZ-22	Sidi Bel Abbès	DZ-23	Annaba	DZ-24	Guelma
DZ-25	Constantine	DZ-26	Médéa	DZ-27	Mostaganem
DZ-28	M’Sila	DZ-29	Mascara	DZ-30	Ouargla
DZ-31	Oran	DZ-32	El Bayadh	DZ-33	Illizi
DZ-34	Bordj Bou Arréridj	DZ-35	Boumerdès	DZ-36	El Tarf
DZ-37	Tindouf	DZ-38	Tissemsilt	DZ-39	El Oued
DZ-40	Khenchela	DZ-41	Souk Ahras	DZ-42	Tipasa
DZ-43	Mila	DZ-44	Aïn Defla	DZ-45	Naama
DZ-46	Aïn Témouchent	DZ-47	Ghardaïa	DZ-48	Relizane

Ecuadorian (EC) States

Code	State	Code	State	Code	State
EC-A	Azuay	EC-B	Bolívar	EC-F	Cañar
EC-C	Carchi	EC-H	Chimborazo	EC-X	Cotopaxi
EC-O	El Oro	EC-E	Esmeraldas	EC-W	Galápagos
EC-G	Guayas	EC-I	Imbabura	EC-L	Loja
EC-R	Los Ríos	EC-M	Manabí	EC-S	Morona-Santiago
EC-N	Napo	EC-D	Orellana	EC-Y	Pastaza
EC-P	Pichincha	EC-SE	Santa Elena	EC-SD	Santo Domingo de los Tsáchilas
EC-U	Sucumbíos	EC-T	Tungurahua	EC-Z	Zamora-Chinchipe

Egyptian (EG) States

Code	State	Code	State	Code	State
EGALX	Alexandria	EGASN	Aswan	EGAST	Asyut
EGBA	Red Sea	EGBH	Beheira	EGBNS	Beni Suef
EGC	Cairo	EGDK	Dakahlia	EGDT	Damietta
EGFYM	Faiyum	EGGH	Gharbia	EGGZ	Giza
EGIS	Ismailia	EGJS	South Sinai	EGKB	Qalyubia
EGKFS	Kafr el-Sheikh	EGKN	Qena	EGLX	Luxor
EGMN	Minya	EGMNF	Monufia	EGMT	Matrouh
EGPTS	Port Said	EGSHG	Sohag	EGSHR	Al Sharqia
EGSIN	North Sinai	EGSUZ	Suez	EGWAD	New Valley

Spanish (ES) States

Code	State	Code	State	Code	State
C	A Coruña	VI	Araba/Álava	AB	Albacete
A	Alicante	AL	Almería	O	Asturias
AV	Ávila	BA	Badajoz	PM	Baleares
B	Barcelona	BU	Burgos	CC	Cáceres
CA	Cádiz	S	Cantabria	CS	Castellón
CE	Ceuta	CR	Ciudad Real	CO	Córdoba
CU	Cuenca	GI	Girona	GR	Granada
GU	Guadalajara	SS	Gipuzkoa	H	Huelva
HU	Huesca	J	Jaén	LO	La Rioja
GC	Las Palmas	LE	León	L	Lleida
LU	Lugo	M	Madrid	MA	Málaga
ML	Melilla	MU	Murcia	NA	Navarra
OR	Ourense	P	Palencia	PO	Pontevedra
SA	Salamanca	TF	Santa Cruz de Tenerife	SG	Segovia
SE	Sevilla	SO	Soria	T	Tarragona
TE	Teruel	TO	Toledo	V	Valencia
VA	Valladolid	BI	Biscay	ZA	Zamora
Z	Zaragoza

Ghanaian (GH) Regions

Code	State	Code	State	Code	State
AF	Ahafo	AH	Ashanti	BA	Brong-Ahafo
BO	Bono	BE	Bono East	CP	Central
EP	Eastern	AA	Greater Accra	NE	North East
NP	Northern	OT	Oti	SV	Savannah
UE	Upper East	UW	Upper West	TV	Volta
WP	Western	WN	Western North

Greek (GR) Regions

Code	State	Code	State	Code	State
I	Attica	A	East Macedonia and Thrace	B	Central Macedonia
C	West Macedonia	D	Epirus	E	Thessaly
F	Ionian Islands	G	West Greece	H	Central Greece
J	Peloponnese	K	North Aegean	L	South Aegean
M	Crete

Guatemalan (GT) States

Code	State	Code	State	Code	State
GT-AV	Alta Verapaz	GT-BV	Baja Verapaz	GT-CM	Chimaltenango
GT-CQ	Chiquimula	GT-PR	El Progreso	GT-ES	Escuintla
GT-GU	Guatemala	GT-HU	Huehuetenango	GT-IZ	Izabal
GT-JA	Jalapa	GT-JU	Jutiapa	GT-PE	Petén
GT-QZ	Quetzaltenango	GT-QC	Quiché	GT-RE	Retalhuleu
GT-SA	Sacatepéquez	GT-SM	San Marcos	GT-SR	Santa Rosa
GT-SO	Sololá	GT-SU	Suchitepéquez	GT-TO	Totonicapán
GT-ZA	Zacapa

Hong Kong (HK) States

Code	State	Code	State	Code	State
HONG KONG	Hong Kong Island	KOWLOON	Kowloon	NEW TERRITORIES	New Territories

Honduran (HN) States

Code	State	Code	State	Code	State
HN-AT	Atlántida	HN-IB	Bay Islands	HN-CH	Choluteca
HN-CL	Colón	HN-CM	Comayagua	HN-CP	Copán
HN-CR	Cortés	HN-EP	El Paraíso	HN-FM	Francisco Morazán
HN-GD	Gracias a Dios	HN-IN	Intibucá	HN-LE	Lempira
HN-LP	La Paz	HN-OC	Ocotepeque	HN-OL	Olancho
HN-SB	Santa Bárbara	HN-VA	Valle	HN-YO	Yoro

Hungarian (HU) States

Code	State	Code	State	Code	State
BK	Bács-Kiskun	BE	Békés	BA	Baranya
BZ	Borsod-Abaúj-Zemplén	BU	Budapest	CS	Csongrád-Csanád
FE	Fejér	GS	Győr-Moson-Sopron	HB	Hajdú-Bihar
HE	Heves	JN	Jász-Nagykun-Szolnok	KE	Komárom-Esztergom
NO	Nógrád	PE	Pest	SO	Somogy
SZ	Szabolcs-Szatmár-Bereg	TO	Tolna	VA	Vas
VE	Veszprém	ZA	Zala

Indonesian (ID) Provinces

Code	State	Code	State	Code	State
AC	Daerah Istimewa Aceh	SU	Sumatera Utara	SB	Sumatera Barat
RI	Riau	KR	Kepulauan Riau	JA	Jambi
SS	Sumatera Selatan	BB	Bangka Belitung	BE	Bengkulu
LA	Lampung	JK	DKI Jakarta	JB	Jawa Barat
BT	Banten	JT	Jawa Tengah	JI	Jawa Timur
YO	Daerah Istimewa Yogyakarta	BA	Bali	NB	Nusa Tenggara Barat
NT	Nusa Tenggara Timur	KB	Kalimantan Barat	KT	Kalimantan Tengah
KI	Kalimantan Timur	KS	Kalimantan Selatan	KU	Kalimantan Utara
SA	Sulawesi Utara	ST	Sulawesi Tengah	SG	Sulawesi Tenggara
SR	Sulawesi Barat	SN	Sulawesi Selatan	GO	Gorontalo
MA	Maluku	MU	Maluku Utara	PA	Papua
PB	Papua Barat

Irish (IE) States

Code	State	Code	State	Code	State
CW	Carlow	CN	Cavan	CE	Clare
CO	Cork	DL	Donegal	D	Dublin
G	Galway	KY	Kerry	KE	Kildare
KK	Kilkenny	LS	Laois	LM	Leitrim
LK	Limerick	LD	Longford	LH	Louth
MO	Mayo	MH	Meath	MN	Monaghan
OY	Offaly	RN	Roscommon	SO	Sligo
TA	Tipperary	WD	Waterford	WH	Westmeath
WX	Wexford	WW	Wicklow

Indian (IN) States

Code	State	Code	State	Code	State
AP	Andhra Pradesh	AR	Arunachal Pradesh	AS	Assam
BR	Bihar	CT	Chhattisgarh	GA	Goa
GJ	Gujarat	HR	Haryana	HP	Himachal Pradesh
JK	Jammu and Kashmir	JH	Jharkhand	KA	Karnataka
KL	Kerala	LA	Ladakh	MP	Madhya Pradesh
MH	Maharashtra	MN	Manipur	ML	Meghalaya
MZ	Mizoram	NL	Nagaland	OR	Odisha
PB	Punjab	RJ	Rajasthan	SK	Sikkim
TN	Tamil Nadu	TS	Telangana	TR	Tripura
UK	Uttarakhand	UP	Uttar Pradesh	WB	West Bengal
AN	Andaman and Nicobar Islands	CH	Chandigarh	DN	Dadra and Nagar Haveli
DD	Daman and Diu	DL	Delhi	LD	Lakshadeep
PY	Puducherry

Iranian (IR) States

Code	State	Code	State	Code	State
KHZ	Khuzestan (خوزستان)	THR	Tehran (تهران)	ILM	Ilaam (ایلام)
BHR	Bushehr (بوشهر)	ADL	Ardabil (اردبیل)	ESF	Isfahan (اصفهان)
YZD	Yazd (یزد)	KRH	Kermanshah (کرمانشاه)	KRN	Kerman (کرمان)
HDN	Hamadan (همدان)	GZN	Ghazvin (قزوین)	ZJN	Zanjan (زنجان)
LRS	Luristan (لرستان)	ABZ	Alborz (البرز)	EAZ	East Azarbaijan (آذربایجان شرقی)
WAZ	West Azarbaijan (آذربایجان غربی)	CHB	Chaharmahal and Bakhtiari (چهارمحال و بختیاری)	SKH	South Khorasan (خراسان جنوبی)
RKH	Razavi Khorasan (خراسان رضوی)	NKH	North Khorasan (خراسان شمالی)	SMN	Semnan (سمنان)
FRS	Fars (فارس)	QHM	Qom (قم)	KRD	Kurdistan / کردستان)
KBD	Kohgiluyeh and BoyerAhmad (کهگیلوییه و بویراحمد)	GLS	Golestan (گلستان)	GIL	Gilan (گیلان)
MZN	Mazandaran (مازندران)	MKZ	Markazi (مرکزی)	HRZ	Hormozgan (هرمزگان)
SBN	Sistan and Baluchestan (سیستان و بلوچستان)

Italian (IT) Provinces

Code	State	Code	State	Code	State
AG	Agrigento	AL	Alessandria	AN	Ancona
AO	Aosta	AR	Arezzo	AP	Ascoli Piceno
AT	Asti	AV	Avellino	BA	Bari
BT	Barletta-Andria-Trani	BL	Belluno	BN	Benevento
BG	Bergamo	BI	Biella	BO	Bologna
BZ	Bolzano	BS	Brescia	BR	Brindisi
CA	Cagliari	CL	Caltanissetta	CB	Campobasso
CE	Caserta	CT	Catania	CZ	Catanzaro
CH	Chieti	CO	Como	CS	Cosenza
CR	Cremona	KR	Crotone	CN	Cuneo
EN	Enna	FM	Fermo	FE	Ferrara
FI	Firenze	FG	Foggia	FC	Forlì-Cesena
FR	Frosinone	GE	Genova	GO	Gorizia
GR	Grosseto	IM	Imperia	IS	Isernia
SP	La Spezia	AQ	L’Aquila	LT	Latina
LE	Lecce	LC	Lecco	LI	Livorno
LO	Lodi	LU	Lucca	MC	Macerata
MN	Mantova	MS	Massa-Carrara	MT	Matera
ME	Messina	MI	Milano	MO	Modena
MB	Monza e della Brianza	NA	Napoli	NO	Novara
NU	Nuoro	OR	Oristano	PD	Padova
PA	Palermo	PR	Parma	PV	Pavia
PG	Perugia	PU	Pesaro e Urbino	PE	Pescara
PC	Piacenza	PI	Pisa	PT	Pistoia
PN	Pordenone	PZ	Potenza	PO	Prato
RG	Ragusa	RA	Ravenna	RC	Reggio Calabria
RE	Reggio Emilia	RI	Rieti	RN	Rimini
RM	Roma	RO	Rovigo	SA	Salerno
SS	Sassari	SV	Savona	SI	Siena
SR	Siracusa	SO	Sondrio	SU	Sud Sardegna
TA	Taranto	TE	Teramo	TR	Terni
TO	Torino	TP	Trapani	TN	Trento
TV	Treviso	TS	Trieste	UD	Udine
VA	Varese	VE	Venezia	VB	Verbano-Cusio-Ossola
VC	Vercelli	VR	Verona	VV	Vibo Valentia
VI	Vicenza	VT	Viterbo

Amaican (JM) parishes

Code	State	Code	State	Code	State
JM-01	Kingston	JM-02	Saint Andrew	JM-03	Saint Thomas
JM-04	Portland	JM-05	Saint Mary	JM-06	Saint Ann
JM-07	Trelawny	JM-08	Saint James	JM-09	Hanover
JM-10	Westmoreland	JM-11	Saint Elizabeth	JM-12	Manchester
JM-13	Clarendon	JM-14	Saint Catherine

Japanese (JP) prefectures

Code	State	Code	State	Code	State
JP01	Hokkaido	JP02	Aomori	JP03	Iwate
JP04	Miyagi	JP05	Akita	JP06	Yamagata
JP07	Fukushima	JP08	Ibaraki	JP09	Tochigi
JP10	Gunma	JP11	Saitama	JP12	Chiba
JP13	Tokyo	JP14	Kanagawa	JP15	Niigata
JP16	Toyama	JP17	Ishikawa	JP18	Fukui
JP19	Yamanashi	JP20	Nagano	JP21	Gifu
JP22	Shizuoka	JP23	Aichi	JP24	Mie
JP25	Shiga	JP26	Kyoto	JP27	Osaka
JP28	Hyogo	JP29	Nara	JP30	Wakayama
JP31	Tottori	JP32	Shimane	JP33	Okayama
JP34	Hiroshima	JP35	Yamaguchi	JP36	Tokushima
JP37	Kagawa	JP38	Ehime	JP39	Kochi
JP40	Fukuoka	JP41	Saga	JP42	Nagasaki
JP43	Kumamoto	JP44	Oita	JP45	Miyazaki
JP46	Kagoshima	JP47	Okinawa

Kenyan (KE) counties

Code	State	Code	State	Code	State
KE01	Baringo	KE02	Bomet	KE03	Bungoma
KE04	Busia	KE05	Elgeyo-Marakwet	KE06	Embu
KE07	Garissa	KE08	Homa Bay	KE09	Isiolo
KE10	Kajiado	KE11	Kakamega	KE12	Kericho
KE13	Kiambu	KE14	Kilifi	KE15	Kirinyaga
KE16	Kisii	KE17	Kisumu	KE18	Kitui
KE19	Kwale	KE20	Laikipia	KE21	Lamu
KE22	Machakos	KE23	Makueni	KE24	Mandera
KE25	Marsabit	KE26	Meru	KE27	Migori
KE28	Mombasa	KE29	Murang’a	KE30	Nairobi County
KE31	Nakuru	KE32	Nandi	KE33	Narok
KE34	Nyamira	KE35	Nyandarua	KE36	Nyeri
KE37	Samburu	KE38	Siaya	KE39	Taita-Taveta
KE40	Tana River	KE41	Tharaka-Nithi	KE42	Trans Nzoia
KE43	Turkana	KE44	Uasin Gishu	KE45	Vihiga
KE46	Wajir	KE47	West Pokot

Laotian (LA) provinces

Code	State	Code	State	Code	State
AT	Attapeu	BK	Bokeo	BL	Bolikhamsai
CH	Champasak	HO	Houaphanh	KH	Khammouane
LM	Luang Namtha	LP	Luang Prabang	OU	Oudomxay
PH	Phongsaly	SL	Salavan	SV	Savannakhet
VI	Vientiane Province	VT	Vientiane	XA	Sainyabuli
XE	Sekong	XI	Xiangkhouang	XS	Xaisomboun

Liberian (LR) provinces

Code	State	Code	State	Code	State
BM	Bomi	BN	Bong	GA	Gbarpolu
GB	Grand Bassa	GC	Grand Cape Mount	GG	Grand Gedeh
GK	Grand Kru	LO	Lofa	MA	Margibi
MY	Maryland	MO	Montserrado	NM	Nimba
RV	Rivercess	RG	River Gee	SN	Sinoe

Moldovan (MD) states

Code	State	Code	State	Code	State
C	Chișinău	BL	Bălți	AN	Anenii Noi
BS	Basarabeasca	BR	Briceni	CH	Cahul
CT	Cantemir	CL	Călărași	CS	Căușeni
CM	Cimișlia	CR	Criuleni	DN	Dondușeni
DR	Drochia	DB	Dubăsari	ED	Edineț
FL	Fălești	FR	Florești	GE	UTA Găgăuzia
GL	Glodeni	HN	Hîncești	IL	Ialoveni
TL	Telenești	UN	Ungheni

Mexican (MX) states

Code	State	Code	State	Code	State
DF	Ciudad de México	JA	Jalisco	NL	Nuevo León
AG	Aguascalientes	BC	Baja California	BS	Baja California Sur
CM	Campeche	CS	Chiapas	CH	Chihuahua
CO	Coahuila	CL	Colima	DG	Durango
GT	Guanajuato	GR	Guerrero	HG	Hidalgo
MX	Estado de México	MI	Michoacán	MO	Morelos
NA	Nayarit	OA	Oaxaca	PU	Puebla
QT	Querétaro	QR	Quintana Roo	SL	San Luis Potosí
SI	Sinaloa	SO	Sonora	TB	Tabasco
TM	Tamaulipas	TL	Tlaxcala	VE	Veracruz
YU	Yucatán	ZA	Zacatecas

Malaysian (MY) states

Code	State	Code	State	Code	State
JHR	Johor	KDH	Kedah	KTN	Kelantan
LBN	Labuan	MLK	Malacca (Melaka)	NSN	Negeri Sembilan
PHG	Pahang	PNG	Penang (Pulau Pinang)	PRK	Perak
PLS	Perlis	SBH	Sabah	SWK	Sarawak
SGR	Selangor	TRG	Terengganu	PJY	Putrajaya
KUL	Kuala Lumpur

Mozambican (MZ) provinces

Code	State	Code	State	Code	State
MZP	Cabo Delgado	MZG	Gaza	MZI	Inhambane
MZB	Manica	MZL	Maputo Province	MZMPM	Maputo
MZN	Nampula	MZA	Niassa	MZS	Sofala
MZT	Tete	MZQ	Zambézia

Namibian (NA) regions

Code	State	Code	State	Code	State
ER	Erongo	HA	Hardap	KA	Karas
KE	Kavango East	KW	Kavango West	KH	Khomas
KU	Kunene	OW	Ohangwena	OH	Omaheke
OS	Omusati	ON	Oshana	OT	Oshikoto
OD	Otjozondjupa	CA	Zambezi

Nigerian (NG) provinces

Code	State	Code	State	Code	State
AB	Abia	FC	Abuja	AD	Adamawa
AK	Akwa Ibom	AN	Anambra	BA	Bauchi
BY	Bayelsa	BE	Benue	BO	Borno
CR	Cross River	DE	Delta	EB	Ebonyi
ED	Edo	EK	Ekiti	EN	Enugu
GO	Gombe	IM	Imo	JI	Jigawa
KD	Kaduna	KN	Kano	KT	Katsina
KE	Kebbi	KO	Kogi	KW	Kwara
LA	Lagos	NA	Nasarawa	NI	Niger
OG	Ogun	ON	Ondo	OS	Osun
OY	Oyo	PL	Plateau	RI	Rivers
SO	Sokoto	TA	Taraba	YO	Yobe
ZA	Zamfara

Nepalese (NP) zones

Code	State	Code	State	Code	State
BAG	Bagmati	BHE	Bheri	DHA	Dhaulagiri
GAN	Gandaki	JAN	Janakpur	KAR	Karnali
KOS	Koshi	LUM	Lumbini	MAH	Mahakali
MEC	Mechi	NAR	Narayani	RAP	Rapti
SAG	Sagarmatha	SET	Seti

Nicaraguan (NI) states

Code	State	Code	State	Code	State
NI-AN	Atlántico Norte	NI-AS	Atlántico Sur	NI-BO	Boaco
NI-CA	Carazo	NI-CI	Chinandega	NI-CO	Chontales
NI-ES	Estelí	NI-GR	Granada	NI-JI	Jinotega
NI-LE	León	NI-MD	Madriz	NI-MN	Managua
NI-MS	Masaya	NI-MT	Matagalpa	NI-NS	Nueva Segovia
NI-RI	Rivas	NI-SJ	Río San Juan

New Zealand (NZ) states

Code	State	Code	State	Code	State
NL	Northland	AK	Auckland	WA	Waikato
BP	Bay of Plenty	TK	Taranaki	GI	Gisborne
HB	Hawke’s Bay	MW	Manawatu-Wanganui	WE	Wellington
NS	Nelson	MB	Marlborough	TM	Tasman
WC	West Coast	CT	Canterbury	OT	Otago
SL	Southland

Panamanian (PA) states

Code	State	Code	State	Code	State
PA-1	Bocas del Toro	PA-2	Coclé	PA-3	Colón
PA-4	Chiriquí	PA-5	Darién	PA-6	Herrera
PA-7	Los Santos	PA-8	Panamá	PA-9	Veraguas
PA-10	West Panamá	PA-EM	Emberá	PA-KY	Guna Yala
PA-NB	Ngöbe-Buglé

Peruvian (PE) states

Code	State	Code	State	Code	State
CAL	El Callao	LMA	Municipalidad Metropolitana de Lima	AMA	Amazonas
ANC	Ancash	APU	Apurímac	ARE	Arequipa
AYA	Ayacucho	CAJ	Cajamarca	CUS	Cusco
HUV	Huancavelica	HUC	Huánuco	ICA	Ica
JUN	Junín	LAL	La Libertad	LAM	Lambayeque
LIM	Lima	LOR	Loreto	MDD	Madre de Dios
MOQ	Moquegua	PAS	Pasco	PIU	Piura
PUN	Puno	SAM	San Martín	TAC	Tacna
TUM	Tumbes	UCA	Ucayali

Philippine (PH) provinces

Code	State	Code	State	Code	State
ABR	Abra	AGN	Agusan del Norte	AGS	Agusan del Sur
AKL	Aklan	ALB	Albay	ANT	Antique
APA	Apayao	AUR	Aurora	BAS	Basilan
BAN	Bataan	BTN	Batanes	BTG	Batangas
BEN	Benguet	BIL	Biliran	BOH	Bohol
BUK	Bukidnon	BUL	Bulacan	CAG	Cagayan
CAN	Camarines Norte	CAS	Camarines Sur	CAM	Camiguin
CAP	Capiz	CAT	Catanduanes	CAV	Cavite
CEB	Cebu	COM	Compostela Valley	NCO	Cotabato
DAV	Davao del Norte	DAS	Davao del Sur	DAC	Davao Occidental
DAO	Davao Oriental	DIN	Dinagat Islands	EAS	Eastern Samar
GUI	Guimaras	IFU	Ifugao	ILN	Ilocos Norte
ILS	Ilocos Sur	ILI	Iloilo	ISA	Isabela
KAL	Kalinga	LUN	La Union	LAG	Laguna
LAN	Lanao del Norte	LAS	Lanao del Sur	LEY	Leyte
MAG	Maguindanao	MAD	Marinduque	MAS	Masbate
MSC	Misamis Occidental	MSR	Misamis Oriental	MOU	Mountain Province
NEC	Negros Occidental	NER	Negros Oriental	NSA	Northern Samar
NUE	Nueva Ecija	NUV	Nueva Vizcaya	MDC	Occidental Mindoro
MDR	Oriental Mindoro	PLW	Palawan	PAM	Pampanga
PAN	Pangasinan	QUE	Quezon	QUI	Quirino
RIZ	Rizal	ROM	Romblon	WSA	Samar
SAR	Sarangani	SIQ	Siquijor	SOR	Sorsogon
SCO	South Cotabato	SLE	Southern Leyte	SUK	Sultan Kudarat
SLU	Sulu	SUN	Surigao del Norte	SUR	Surigao del Sur
TAR	Tarlac	TAW	Tawi-Tawi	ZMB	Zambales
ZAN	Zamboanga del Norte	ZAS	Zamboanga del Sur	ZSI	Zamboanga Sibugay
00	Metro Manila

Pakistani (PK) states

Code	State	Code	State	Code	State
JK	Azad Kashmir	BA	Balochistan	TA	FATA
GB	Gilgit Baltistan	IS	Islamabad Capital Territory	KP	Khyber Pakhtunkhwa
PB	Punjab	SD	Sindh

Paraguayan (PY) states

Code	State	Code	State	Code	State
PY-ASU	Asunción	PY-1	Concepción	PY-2	San Pedro
PY-3		PY-4	Guairá	PY-5	Caaguazú
PY-6	Caazapá	PY-7	Itapúa	PY-8	Misiones
PY-9	Paraguarí	PY-10	Alto Paraná	PY-11	Central
PY-12	Ñeembucú	PY-13	Amambay	PY-14	Canindeyú
PY-15	Presidente Hayes	PY-16	Alto Paraguay	PY-17	Boquerón

Romanian (RO) states

Code	State	Code	State	Code	State
AB	Alba	AR	Arad	AG	Argeș
BC	Bacău	BH	Bihor	BN	Bistrița-Năsăud
BT	Botoșani	BR	Brăila	BV	Brașov
B	București	BZ	Buzău	CL	Călărași
CS	Caraș-Severin	CJ	Cluj	CT	Constanța
CV	Covasna	DB	Dâmbovița	DJ	Dolj
GL	Galați	GR	Giurgiu	GJ	Gorj
HR	Harghita	HD	Hunedoara	IL	Ialomița
IS	Iași	IF	Ilfov	MM	Maramureș
MH	Mehedinți	MS	Mureș	NT	Neamț
OT	Olt	PH	Prahova	SJ	Sălaj
SM	Satu Mare	SB	Sibiu	SV	Suceava
TR	Teleorman	TM	Timiș	TL	Tulcea
VL	Vâlcea	VS	Vaslui	VN	Vrancea

Salvadoran (SV) states

Code	State	Code	State	Code	State
SV-AH	Ahuachapán	SV-CA	Cabañas	SV-CH	Chalatenango
SV-CU	Cuscatlán	SV-LI	La Libertad	SV-MO	Morazán
SV-PA	La Paz	SV-SA	Santa Ana	SV-SM	San Miguel
SV-SO	Sonsonate	SV-SS	San Salvador	SV-SV	San Vicente
SV-UN	La Unión	SV-US	Usulután

Thai (TH) states

Code	State	Code	State	Code	State
TH-37	Amnat Charoen	TH-15	Ang Thong	TH-14	Ayutthaya
TH-10	Bangkok	TH-38	Bueng Kan	TH-31	Buri Ram
TH-24	Chachoengsao	TH-18	Chai Nat	TH-36	Chaiyaphum
TH-22	Chanthaburi	TH-50	Chiang Mai	TH-57	Chiang Rai
TH-20	Chonburi	TH-86	Chumphon	TH-46	Kalasin
TH-62	Kamphaeng Phet	TH-71	Kanchanaburi	TH-40	Khon Kaen
TH-81	Krabi	TH-52	Lampang	TH-51	Lamphun
TH-42	Loei	TH-16	Lopburi	TH-58	Mae Hong Son
TH-44	Maha Sarakham	TH-49	Mukdahan	TH-26	Nakhon Nayok
TH-73	Nakhon Pathom	TH-48	Nakhon Phanom	TH-30	Nakhon Ratchasima
TH-60	Nakhon Sawan	TH-80	Nakhon Si Thammarat	TH-55	Nan
TH-96	Narathiwat	TH-39	Nong Bua Lam Phu	TH-43	Nong Khai
TH-12	Nonthaburi	TH-13	Pathum Thani	TH-94	Pattani
TH-82	Phang Nga	TH-93	Phatthalung	TH-56	Phayao
TH-67	Phetchabun	TH-76	Phetchaburi	TH-66	Phichit
TH-65	Phitsanulok	TH-54	Phrae	TH-83	Phuket
TH-25	Prachin Buri	TH-77	Prachuap Khiri Khan	TH-85	Ranong
TH-70	Ratchaburi	TH-21	Rayong	TH-45	Roi Et
TH-27	Sa Kaeo	TH-47	Sakon Nakhon	TH-11	Samut Prakan
TH-74	Samut Sakhon	TH-75	Samut Songkhram	TH-19	Saraburi
TH-91	Satun	TH-17	Sing Buri	TH-33	Sisaket
TH-90	Songkhla	TH-64	Sukhothai	TH-72	Suphan Buri
TH-84	Surat Thani	TH-32	Surin	TH-63	Tak
TH-92	Trang	TH-23	Trat	TH-34	Ubon Ratchathani
TH-41	Udon Thani	TH-61	Uthai Thani	TH-53	Uttaradit
TH-95	Yala	TH-35	Yasothon

Turkish (TR) states

Code	State	Code	State	Code	State
TR01	Adana	TR02	Adıyaman	TR03	Afyon
TR04	Ağrı	TR05	Amasya	TR06	Ankara
TR07	Antalya	TR08	Artvin	TR09	Aydın
TR10	Balıkesir	TR11	Bilecik	TR12	Bingöl
TR13	Bitlis	TR14	Bolu	TR15	Burdur
TR16	Bursa	TR17	Çanakkale	TR18	Çankırı
TR19	Çorum	TR20	Denizli	TR21	Diyarbakır
TR22	Edirne	TR23	Elazığ	TR24	Erzincan
TR25	Erzurum	TR26	Eskişehir	TR27	Gaziantep
TR28	Giresun	TR29	Gümüşhane	TR30	Hakkari
TR31	Hatay	TR32	Isparta	TR33	İçel
TR34	İstanbul	TR35	İzmir	TR36	Kars
TR37	Kastamonu	TR38	Kayseri	TR39	Kırklareli
TR40	Kırşehir	TR41	Kocaeli	TR42	Konya
TR43	Kütahya	TR44	Malatya	TR45	Manisa
TR46	Kahramanmaraş	TR47	Mardin	TR48	Muğla
TR49	Muş	TR50	Nevşehir	TR51	Niğde
TR52	Ordu	TR53	Rize	TR54	Sakarya
TR55	Samsun	TR56	Siirt	TR57	Sinop
TR58	Sivas	TR59	Tekirdağ	TR60	Tokat
TR61	Trabzon	TR62	Tunceli	TR63	Şanlıurfa
TR64	Uşak	TR65	Van	TR66	Yozgat
TR67	Zonguldak	TR68	Aksaray	TR69	Bayburt
TR70	Karaman	TR71	Kırıkkale	TR72	Batman
TR73	Şırnak	TR74	Bartın	TR75	Ardahan
TR76	Iğdır	TR77	Yalova	TR78	Karabük
TR79	Kilis	TR80	Osmaniye	TR81	Düzce

Tanzanian (TZ) states

Code	State	Code	State	Code	State
TZ01	Arusha	TZ02	Dar es Salaam	TZ03	Dodoma
TZ04	Iringa	TZ05	Kagera	TZ06	Pemba North
TZ07	Zanzibar North	TZ08	Kigoma	TZ09	Kilimanjaro
TZ10	Pemba South	TZ11	Zanzibar South	TZ12	Lindi
TZ13	Mara	TZ14	Mbeya	TZ15	Zanzibar West
TZ16	Morogoro	TZ17	Mtwara	TZ18	Mwanza
TZ19	Coast	TZ20	Rukwa	TZ21	Ruvuma
TZ22	Shinyanga	TZ23	Singida	TZ24	Tabora
TZ25	Tanga	TZ26	Manyara	TZ27	Geita
TZ28	Katavi	TZ29	Njombe	TZ30	Simiyu

Serbian (RS) districts

Code	State	Code	State	Code	State
RS00	Belgrade	RS14	Bor	RS11	Braničevo
RS02	Central Banat	RS10	Danube	RS23	Jablanica
RS09	Kolubara	RS08	Mačva	RS17	Morava
RS20	Nišava	RS01	North Bačka	RS03	North Banat
RS24	Pčinja	RS22	Pirot	RS13	Pomoravlje
RS19	Rasina	RS18	Raška	RS06	South Bačka
RS04	South Banat	RS07	Srem	RS12	Šumadija
RS21	Toplica	RS05	West Bačka	RS15	Zaječar
RS16	Zlatibor	RS25	Kosovo	RS26	Peć
RS27	Prizren	RS28	Kosovska Mitrovica	RS29	Kosovo-Pomoravlje
RSKM	Kosovo-Metohija	RSVO	Vojvodina

Ukrainian (UA) oblasts

Code	State	Code	State	Code	State
VN	Vinnytsia Oblast	VL	Volyn Oblast	DP	Dnipropetrovsk Oblast
DT	Donetsk Oblast	ZT	Zhytomyr Oblast	ZK	Zakarpattia Oblast
ZP	Zaporizhzhia Oblast	IF	Ivano-Frankivsk Oblast	KV	Kyiv Oblast
KH	Kirovohrad Oblast	LH	Luhansk Oblast	LV	Lviv Oblast
MY	Mykolaiv Oblast	OD	Odessa Oblast	PL	Poltava Oblast
RV	Rivne Oblast	SM	Sumy Oblast	TP	Ternopil Oblast
KK	Kharkiv Oblast	KS	Kherson Oblast	KM	Khmelnytskyi Oblast
CK	Cherkasy Oblast	CH	Chernihiv Oblast	CV	Chernivtsi Oblast

Ugandan (UG) districts

Code	State	Code	State	Code	State
UG314	Abim	UG301	Adjumani	UG322	Agago
UG323	Alebtong	UG315	Amolatar	UG324	Amudat
UG216	Amuria	UG316	Amuru	UG302	Apac
UG303	Arua	UG217	Budaka	UG218	Bududa
UG201	Bugiri	UG235	Bugweri	UG420	Buhweju
UG117	Buikwe	UG219	Bukedea	UG118	Bukomansimbi
UG220	Bukwa	UG225	Bulambuli	UG416	Buliisa
UG401	Bundibugyo	UG430	Bunyangabu	UG402	Bushenyi
UG202	Busia	UG221	Butaleja	UG119	Butambala
UG233	Butebo	UG120	Buvuma	UG226	Buyende
UG317	Dokolo	UG121	Gomba	UG304	Gulu
UG403	Hoima	UG417	Ibanda	UG203	Iganga
UG418	Isingiro	UG204	Jinja	UG318	Kaabong
UG404	Kabale	UG405	Kabarole	UG213	Kaberamaido
UG427	Kagadi	UG428	Kakumiro	UG101	Kalangala
UG222	Kaliro	UG122	Kalungu	UG102	Kampala
UG205	Kamuli	UG413	Kamwenge	UG414	Kanungu
UG206	Kapchorwa	UG236	Kapelebyong	UG126	Kasanda
UG406	Kasese	UG207	Katakwi	UG112	Kayunga
UG407	Kibaale	UG103	Kiboga	UG227	Kibuku
UG432	Kikuube	UG419	Kiruhura	UG421	Kiryandongo
UG408	Kisoro	UG305	Kitgum	UG319	Koboko
UG325	Kole	UG306	Kotido	UG208	Kumi
UG333	Kwania	UG228	Kween	UG123	Kyankwanzi
UG422	Kyegegwa	UG415	Kyenjojo	UG125	Kyotera
UG326	Lamwo	UG307	Lira	UG229	Luuka
UG104	Luwero	UG124	Lwengo	UG114	Lyantonde
UG223	Manafwa	UG320	Maracha	UG105	Masaka
UG409	Masindi	UG214	Mayuge	UG209	Mbale
UG410	Mbarara	UG423	Mitooma	UG115	Mityana
UG308	Moroto	UG309	Moyo	UG106	Mpigi
UG107	Mubende	UG108	Mukono	UG334	Nabilatuk
UG311	Nakapiripirit	UG116	Nakaseke	UG109	Nakasongola
UG230	Namayingo	UG234	Namisindwa	UG224	Namutumba
UG327	Napak	UG310	Nebbi	UG231	Ngora
UG424	Ntoroko	UG411	Ntungamo	UG328	Nwoya
UG331	Omoro	UG329	Otuke	UG321	Oyam
UG312	Pader	UG332	Pakwach	UG210	Pallisa
UG110	Rakai	UG429	Rubanda	UG425	Rubirizi
UG431	Rukiga	UG412	Rukungiri	UG111	Sembabule
UG232	Serere	UG426	Sheema	UG215	Sironko
UG211	Soroti	UG212	Tororo	UG113	Wakiso
UG313	Yumbe	UG330	Zombo

United States Minor Outlying Islands (UM)

Code	State	Code	State	Code	State
81	Baker Island	84	Howland Island	86	Jarvis Island
67	Johnston Atoll	89	Kingman Reef	71	Midway Atoll
76	Navassa Island	95	Palmyra Atoll	79	Wake Island

United States (US) states

Code	State	Code	State	Code	State
AL	Alabama	AK	Alaska	AZ	Arizona
AR	Arkansas	CA	California	CO	Colorado
CT	Connecticut	DE	Delaware	DC	District Of Columbia
FL	Florida	GA	Georgia	HI	Hawaii
ID	Idaho	IL	Illinois	IN	Indiana
IA	Iowa	KS	Kansas	KY	Kentucky
LA	Louisiana	ME	Maine	MD	Maryland
MA	Massachusetts	MI	Michigan	MN	Minnesota
MS	Mississippi	MO	Missouri	MT	Montana
NE	Nebraska	NV	Nevada	NH	New Hampshire
NJ	New Jersey	NM	New Mexico	NY	New York
NC	North Carolina	ND	North Dakota	OH	Ohio
OK	Oklahoma	OR	Oregon	PA	Pennsylvania
RI	Rhode Island	SC	South Carolina	SD	South Dakota
TN	Tennessee	TX	Texas	UT	Utah
VT	Vermont	VA	Virginia	WA	Washington
WV	West Virginia	WI	Wisconsin	WY	Wyoming
AA	Armed Forces (AA)	AE	Armed Forces (AE)	AP	Armed Forces (AP)

Uruguayan (UY) states

Code	State	Code	State	Code	State
UY-AR	Artigas	UY-CA	Canelones	UY-CL	Cerro Largo
UY-CO	Colonia	UY-DU	Durazno	UY-FS	Flores
UY-FD	Florida	UY-LA	Lavalleja	UY-MA	Maldonado
UY-MO	Montevideo	UY-PA	Paysandú	UY-RN	Río Negro
UY-RV	Rivera	UY-RO	Rocha	UY-SA	Salto
UY-SJ	San José	UY-SO	Soriano	UY-TA	Tacuarembó
UY-TT	Treinta y Tres

Venezuelan (VE) states

Code	State	Code	State	Code	State
VE-A	Capital	VE-B	Anzoátegui	VE-C	Apure
VE-D	Aragua	VE-E	Barinas	VE-F	Bolívar
VE-G	Carabobo	VE-H	Cojedes	VE-I	Falcón
VE-J	Guárico	VE-K	Lara	VE-L	Mérida
VE-M	Miranda	VE-N	Monagas	VE-O	Nueva Esparta
VE-P	Portuguesa	VE-R	Sucre	VE-S	Táchira
VE-T	Trujillo	VE-U	Yaracuy	VE-V	Zulia
VE-W	Federal Dependencies	VE-X	La Guaira (Vargas)	VE-Y	Delta Amacuro
VE-Z	Amazonas

South African (ZA) states

Code	State	Code	State	Code	State
EC	Eastern Cape	FS	Free State	GP	Gauteng
KZN	KwaZulu-Natal	LP	Limpopo	MP	Mpumalanga
NC	Northern Cape	NW	North West	WC	Western Cape

Zambian (ZM) provinces

Code	State	Code	State	Code	State
ZM-01	Western	ZM-02	Central	ZM-03	Eastern
ZM-04	Luapula	ZM-05	Northern	ZM-06	North-Western
ZM-07	Southern	ZM-08	Copperbelt	ZM-09	Lusaka
ZM-10	Muchinga

How to Use WooCommerce Country Codes in Your Store

When customers visit your WooCommerce store and proceed to checkout, the default country and state must be set correctly to provide a smooth experience.

By default, WooCommerce uses your store address to guess the customer’s location. However, you can explicitly set the default country and state to match your primary market or most frequent customer base. This helps reduce friction and speeds up the checkout process.

How to set it:

Go to your WordPress admin dashboard.
Navigate to WooCommerce > Settings > General.
Find the Selling location(s) and Default customer location options.
Under Default customer location, select Specific country, and pick the country using the two-letter ISO country code (e.g., US for the United States, CA for Canada).
To set the default state, you may need to add a small snippet of code or use a plugin that allows setting default states by country codes.

Using the correct country and state codes ensures the checkout fields are pre-filled with the right default values, enhancing the user experience.

Restricting Sales to Specific Countries or States Using Country Codes

If you want to restrict where you sell or ship products, WooCommerce allows you to limit sales to specific countries — or even states — using country/state codes.

Why restrict sales?

You only want to sell to countries where you can ship.
Tax regulations require limiting sales by location.
Business strategy dictates regional availability.

How to set it:

Go to WooCommerce > Settings > General.
Under Selling location(s), select Sell to specific countries.
Enter the ISO country codes of the countries you want to sell to, separated by commas (e.g., US,CA,GB).
To restrict by states or provinces, use a plugin or customization that accepts codes like US-NY for New York or CA-ON for Ontario.

Adding Custom Countries or States (Step-by-Step Guide)

Sometimes you may want to add custom countries or states not available in WooCommerce by default — e.g., territories or special regions.

Step 1: Add a custom country

add_filter( 'woocommerce_countries', 'add_custom_country' );

function add_custom_country( $countries )

{

$countries['XX'] = 'Customland'; // 'XX' = new country code

return $countries;

<span style="font-weight: 400;">}

Step 2: Add states to that custom country

add_filter( 'woocommerce_states', 'add_custom_country_states' );

function add_custom_country_states( $states ) {

$states['XX'] = array(

'XX-01' => 'Custom State 1',

'XX-02' => 'Custom State 2',

);

return $states;

}

Step 3: Use them in WooCommerce settings

Your custom country and states will now show up throughout WooCommerce — including checkout, shipping zones, and tax rules.

Modifying Country or State Names Shown to Users

You can also change how country or state names appear to customers — ideal for localization, branding, or translations.

Rename a country’s display name:

add_filter( 'woocommerce_countries', 'modify_country_names' );

function modify_country_names( $countries ) {

if ( isset( $countries['US'] ) ) {

$countries['US'] = 'United States of Awesome';

}

return $countries;

}

Rename a state’s display name:

add_filter( 'woocommerce_states', 'modify_state_names' );

function modify_state_names( $states ) {

if ( isset( $states['US']['CA'] ) ) {

$states['US']['CA'] = 'California Dreamin\'';

}

return $states;

}

Using Country Codes in Shipping & Tax Plugins

Most WooCommerce shipping and tax plugins rely on country and state codes to work properly.

Examples include:

Shipping Zones — configured using country/state codes (e.g., US, US-TX).
Tax Rules — applied to specific regions using codes for correct tax calculation.
Third-Party Plugins: such as the powerful Tax Display by Country for WooCommerce plugin, which displays product prices inclusive/exclusive of tax based on the customer’s country code.

Using official ISO country and state codes ensures compatibility and prevents configuration errors.

WooCommerce and cache – Part 2: new Cache Handler plugin

03/06/2016/in Blog, General, News

Read Part 1: WooCommerce Currency Switcher and cache – Making them work together

Some months ago, we wrote about one of the most common issues faced by merchants who run highly dynamic websites, which include multi-currency, multi-pricing, geolocation features: stale content served by rigid caching systems.

In brief, there are quite a few caching systems designed with the assumption that the content of a site is the same for anyone. No matter who is opening a page, they serve the same information. This is correct for relatively static sites, such as blogs, which show the same articles to every member of the audience, or simple e-shops, where the prices are set, and are the same for every customer.

In a few words, many caching systems assume that, given a page on a site, the content of such page will always be the same, without exception. As we explained, this is incorrect when a site is highly dynamic. A shop that handles multiple currencies may be showing different prices to different visitors, or it might need to show a different tax rate (this is actually a requirement in many countries), on the exact same page.

With a static caching system, the result is that users may end up seeing the wrong content. This makes for a worse user experience, and can have an impact on conversion.

After an in-depth analysis, and several experiments, we came to a conclusion: issues caused by the caching system must be solved by the caching system. Based on this approach, we prepared an algorithm for dynamic caching that handles the needs of a multi-currency, multi-pricing, multi-language shop as it should, without compromising on the performance. This, in our opinion, is the correct way to address the issue.

The status of Dynamic Caching today

We keep contacting as many hosting providers as possible, explaining them how they should update their caching systems to bring them up to speed. Our objective is to make it clear that handling highly dynamic caching is a must, not just a “frill”.

Quite a few providers agreed with our approach, and allow their customers to customise the caching logic as required. Others, like the WP Engine team, showed interest in our solution, and are currently reviewing it, for future implementation. There are some who are still “lagging behind”, and there are a few, such as CloudFlare, who only offer dynamic caching on their most expensive plans.

Due to these limitations, imposed by an obsolete architecture, merchants have make a difficult decision:

Change hosting/service provider and move to one that handles caching as it should. This would make sense, but it’s not always possible. Besides, merchants might have invested a significant sum in current service.
Disable the caching system they are using, and for which they might have been paying a service fee.
Abandon the idea of a multi-currency, multi-language site, potentially risking to drive away audience.

While we still maintain that caching issues must be addressed on the caching layer, we wanted to find a solution that would help merchants, at least temporarily, while the service providers update their system.

Welcome our new plugin: WooCommerce Cache Handler

Thanks to our customers’ support, we are happy to announce the release of the WooCommerce Cache Handler plugin (currently in Beta stage). This new plugin can be used as a workaround with rigid caching systems, such as CloudFlare, SiteGround “Dynamic” Cache (which is actually static), as well as plugins that don’t support dynamic caching, such as W3 Total Cache.

Please note that our recommendation is still to consider switching to a more flexible solution, but this plugin will cover you until you are ready for that change.

How it works

The WooCommerce Cache Handler is simple to use. All you have to do after installing the plugin is go to WooCommerce Settings > Cache Handler and choose the handler you prefer.

WooCommerce Cache Handler - Configuration page

Configuring WooCommerce Cache Handler is extremely easy. Simply choose your favourite handler, clear the cache, and you are ready to go!

After that simple selection, the Cache Handler will support our Currency Switcher, Prices by Country, Tax Display by Country, and all our other WooCommerce plugins.

Currently, there are three options available.

1. Disabled

As the name implies, this disable all the features of the plugin. It can be useful for testing.

2. Redirect

This option is an almost exact equivalent of the “caching support” feature implemented by WooCommerce, which is enabled when the Default Customer Address is set to Geolocate (with page caching support).

The major difference from the standard feature is that our handler takes into account details such as the currency, customer’s country, customer’s state, customer’s tax exemption, and so on, ensuring that the correct content is served to customers based on these parameters. Like the original workaround from which it was derived, this handler appends a random string to URLs.

Benefits and drawbacks

+ The Redirect handler is based on the original workaround implemented by WooCommerce.
+ This solution works on a page level, thus it can produce the correct content with any configuration, or 3rd party plugins.
– The URLs look “ugly”, due to the string appended to them to work around the limitations of caching.

3. Ajax Loader

The Ajax Loader is an alternative to the Redirect, and it’s more elegant, as it doesn’t alter page URLs with ugly, random text. This handler loads all pricing elements via Ajax, when the page load is completed. The result is the following:

A visitor connects to your site from the US. He would like to see USD.
The rigid caching system has the page cached in EUR, and serves it to the customer.
The Ajax Loader kicks in as soon as the page is loaded, requesting the updated prices from the server. After a brief moment, all elements that were displayed in EUR are changed to USD, as the visitor would expect.This update is very quick, and, at the moment, it processes the following standard elements :
– Product prices
– Currency selectors
– Price filter widget
– Custom prices displayed with the Currency Switcher shortcodes.

Benefits and drawbacks

+ The Ajax Loader is a more elegant solution than reloading the page after appending a random string to the URL.
+ Page load is faster, as there is no redirect.
+ URLs are not altered. There is no random text appended to them.
– The Ajax Loader can only process standard elements on the page. If 3rd party plugins add their own pricing elements, such addon prices, custom totals, etc, those won’t be updated. It will be up to the 3rd party plugins’ authors to “hook” into the Ajax Loader and refresh their elements via Ajax.

How to get the WooCommerce Cache Handler

The WooCommerce Cache Handler is available free of charge. Please feel free to download and try it, and see how it works for you. Whether you are using CloudFlare, SiteGround, WP Engine, Flywheel, or any other service with static caching, the Cache Handler got you covered!

Questions? Feedback?

The Cache Handler is still in Beta stage and that, as any free plugin, it’s not covered our free support. We would recommend to try it on a staging copy of your site, so that the live site won’t not affected by bugs that we eventually have to address.

We also would like to encourage you to share your feedback by contacting us. If you wish to contribute to the development of this plugin, you are more than welcome to do so!

Thanks for reading, and see you soon on aelia.co!

The Aelia Team

WooCommerce Currency Switcher and cache – Making them work together

02/10/2015/in Blog, General, News

This article continues in WooCommerce and cache – Part 2: new Cache Handler plugin

One of the most common questions we receive from our customers is how to make a highly dynamic, multi-currency, multi-pricing, geolocation-enabled sites work properly with caching enabled. This is not always an easy task, because caching systems are designed with the assumption that the content served by a site doesn’t change depending on the visitor. Such assumption holds true in many cases, as a large number of sites does indeed serve the same content to whoever views a page. In such case, the standard behaviour of caching systems, which is storing one copy of each page in the cache, is acceptable.

As soon as multi-currency features are added, the same behaviour proves itself too limited, because the assumption behind it becomes incorrect. A multi-currency shop serves different content to different visitors, depending on the currency and other criteria (applicable taxes, regional pricing, etc). Quite simply, having one cached copy of each page just doesn’t cut it anymore.

Until recently, the only way to prevent caching from interfering with the multi-currency features was to disable it on catalogue pages. Doing so ensures that the shop can produce content dynamically, showing the correct information to each visitor. In some cases, when the caching system in use is too rigid, this is still the only solution.

How WooCommerce handles the issue

WooCommerce itself has to deal with caching since its team introduced geolocation features in it. The WC team added a workaround to “trick” caching systems into letting WooCommerce serve the correct data. Such workaround works by reloading the shop pages in a way that cache is ignored. This ensures that the page shows the correct content but, in our opinion, it’s not an ideal approach. We certainly appreciate the effort put into it, and the fact that there isn’t much more that a plugin can do to correct the behaviour of the caching system. However, we decided to find an alternative, more robust solution.

Our solution

Our opinion is that caching systems should adapt to your site, not the other way round. Issues caused by caching should be solved by fixing the caching. With this in mind, instead of implementing a workaround, we tackled the issue at its root, and wrote an algorithm for dynamic caching that takes into account the needs of a multi-currency website.

The algorithm is straightforward, and solves the issue by addressing its cause: instead of one copy of each page, it allows caching systems and plugins to store multiple copies of each page (such as one for each currency). With that in place, visitors from all over the world will see the content that applies to them, with the correct currency and taxes applied. If visitors choose another currency, or country, then our plugins track their choice, and the dynamic caching logic uses it to serve them the correct content.

Our solution grants top performance, with maximum flexibility.

Supported Systems

Dynamic caching is a great solution for highly dynamic, multi-currency sites. However, it can only work if the caching system in use supports it. As of October 2015, the following plugins and systems support, or are planning to support, dynamic caching.

WordPress Plugins

ZenCache/Comet Cache
WP Rocket (supports dynamic caching natively, since version 2.7)
Litespeed Caching

Caching Systems

Nginx
CloudFlare (currently only supported on Enterprise plan)
Varnish

For caching plugins and systems that do not support dynamic caching, disabling cache on catalogue pages is still necessary to allow the multi-currency features to work correctly.

How to add dynamic caching to your site

Adding it to your site can be as simple as copying one file, or changing one configuration file. In order to allow you to get started quickly, we wrote an implementation of dynamic caching for the following systems:

ZenCache/Comet Cache
Nginx

You can find detailed instructions to install and configure each of our solutions, as well as indications for other systems, in our knowledge base: How to add dynamic caching to your site.

We also discussed the implementation extensively with the WP Rocket Team, and provided them with code examples for integration. They confirmed that they are going to add support for dynamic caching and multi-currency sites directly in their plugin.

With dynamic caching and our Currency Switcher, your WooCommerce site will be faster and more flexible than ever!

What about systems that don’t support dynamic caching?

Plugins and caching systems that don’t support dynamic caching still have to be disabled on the catalogue, at least until they are updated. We believe that caching systems should be flexible, and support for dynamic caching is not particularly difficult to implement.

If you are using a plugin, or a caching system that doesn’t support dynamic caching, we recommend thar you get in touch with its authors and express your interest in such feature. You can also suggest them to contact us directly, if they have any questions. We will be happy to provide them with all the information they need to improve their solution.

Questions? Feedback?

We hope that you enjoyed this great news. A faster e-commerce means more customers, and that is always good! If you have any questions about our solutions, or if you would like to send us your feedback, please feel free to contact us. We will get back to you in no time.

Thank for your time and continued support.

The Aelia Team