Choose a version:

CountryCode

enum

The code designating a country/region, which generally follows ISO 3166-1 alpha-2 guidelines. If a territory doesn't have a country code value in the CountryCode enum, then it might be considered a subdivision of another country. For example, the territories associated with Spain are represented by the country code ES, and the territories associated with the United States of America are represented by the country code US.

Anchor to Valid valuesValid values

Anchor to ACAC: Ascension Island.
Anchor to ADAD: Andorra.
Anchor to AEAE: United Arab Emirates.
Anchor to AFAF: Afghanistan.
Anchor to AGAG: Antigua & Barbuda.
Anchor to AIAI: Anguilla.
Anchor to ALAL: Albania.
Anchor to AMAM: Armenia.
Anchor to ANAN: Netherlands Antilles.
Anchor to AOAO: Angola.
Anchor to ARAR: Argentina.
Anchor to ATAT: Austria.
Anchor to AUAU: Australia.
Anchor to AWAW: Aruba.
Anchor to AXAX: Åland Islands.
Anchor to AZAZ: Azerbaijan.
Anchor to BABA: Bosnia & Herzegovina.
Anchor to BBBB: Barbados.
Anchor to BDBD: Bangladesh.
Anchor to BEBE: Belgium.
Anchor to BFBF: Burkina Faso.
Anchor to BGBG: Bulgaria.
Anchor to BHBH: Bahrain.
Anchor to BIBI: Burundi.
Anchor to BJBJ: Benin.
Anchor to BLBL: St. Barthélemy.
Anchor to BMBM: Bermuda.
Anchor to BNBN: Brunei.
Anchor to BOBO: Bolivia.
Anchor to BQBQ: Caribbean Netherlands.
Anchor to BRBR: Brazil.
Anchor to BSBS: Bahamas.
Anchor to BTBT: Bhutan.
Anchor to BVBV: Bouvet Island.
Anchor to BWBW: Botswana.
Anchor to BYBY: Belarus.
Anchor to BZBZ: Belize.
Anchor to CACA: Canada.
Anchor to CCCC: Cocos (Keeling) Islands.
Anchor to CDCD: Congo - Kinshasa.
Anchor to CFCF: Central African Republic.
Anchor to CGCG: Congo - Brazzaville.
Anchor to CHCH: Switzerland.
Anchor to CICI: Côte d’Ivoire.
Anchor to CKCK: Cook Islands.
Anchor to CLCL: Chile.
Anchor to CMCM: Cameroon.
Anchor to CNCN: China.
Anchor to COCO: Colombia.
Anchor to CRCR: Costa Rica.
Anchor to CUCU: Cuba.
Anchor to CVCV: Cape Verde.
Anchor to CWCW: Curaçao.
Anchor to CXCX: Christmas Island.
Anchor to CYCY: Cyprus.
Anchor to CZCZ: Czechia.
Anchor to DEDE: Germany.
Anchor to DJDJ: Djibouti.
Anchor to DKDK: Denmark.
Anchor to DMDM: Dominica.
Anchor to DODO: Dominican Republic.
Anchor to DZDZ: Algeria.
Anchor to ECEC: Ecuador.
Anchor to EEEE: Estonia.
Anchor to EGEG: Egypt.
Anchor to EHEH: Western Sahara.
Anchor to ERER: Eritrea.
Anchor to ESES: Spain.
Anchor to ETET: Ethiopia.
Anchor to FIFI: Finland.
Anchor to FJFJ: Fiji.
Anchor to FKFK: Falkland Islands.
Anchor to FOFO: Faroe Islands.
Anchor to FRFR: France.
Anchor to GAGA: Gabon.
Anchor to GBGB: United Kingdom.
Anchor to GDGD: Grenada.
Anchor to GEGE: Georgia.
Anchor to GFGF: French Guiana.
Anchor to GGGG: Guernsey.
Anchor to GHGH: Ghana.
Anchor to GIGI: Gibraltar.
Anchor to GLGL: Greenland.
Anchor to GMGM: Gambia.
Anchor to GNGN: Guinea.
Anchor to GPGP: Guadeloupe.
Anchor to GQGQ: Equatorial Guinea.
Anchor to GRGR: Greece.
Anchor to GSGS: South Georgia & South Sandwich Islands.
Anchor to GTGT: Guatemala.
Anchor to GWGW: Guinea-Bissau.
Anchor to GYGY: Guyana.
Anchor to HKHK: Hong Kong SAR.
Anchor to HMHM: Heard & McDonald Islands.
Anchor to HNHN: Honduras.
Anchor to HRHR: Croatia.
Anchor to HTHT: Haiti.
Anchor to HUHU: Hungary.
Anchor to IDID: Indonesia.
Anchor to IEIE: Ireland.
Anchor to ILIL: Israel.
Anchor to IMIM: Isle of Man.
Anchor to ININ: India.
Anchor to IOIO: British Indian Ocean Territory.
Anchor to IQIQ: Iraq.
Anchor to IRIR: Iran.
Anchor to ISIS: Iceland.
Anchor to ITIT: Italy.
Anchor to JEJE: Jersey.
Anchor to JMJM: Jamaica.
Anchor to JOJO: Jordan.
Anchor to JPJP: Japan.
Anchor to KEKE: Kenya.
Anchor to KGKG: Kyrgyzstan.
Anchor to KHKH: Cambodia.
Anchor to KIKI: Kiribati.
Anchor to KMKM: Comoros.
Anchor to KNKN: St. Kitts & Nevis.
Anchor to KPKP: North Korea.
Anchor to KRKR: South Korea.
Anchor to KWKW: Kuwait.
Anchor to KYKY: Cayman Islands.
Anchor to KZKZ: Kazakhstan.
Anchor to LALA: Laos.
Anchor to LBLB: Lebanon.
Anchor to LCLC: St. Lucia.
Anchor to LILI: Liechtenstein.
Anchor to LKLK: Sri Lanka.
Anchor to LRLR: Liberia.
Anchor to LSLS: Lesotho.
Anchor to LTLT: Lithuania.
Anchor to LULU: Luxembourg.
Anchor to LVLV: Latvia.
Anchor to LYLY: Libya.
Anchor to MAMA: Morocco.
Anchor to MCMC: Monaco.
Anchor to MDMD: Moldova.
Anchor to MEME: Montenegro.
Anchor to MFMF: St. Martin.
Anchor to MGMG: Madagascar.
Anchor to MKMK: North Macedonia.
Anchor to MLML: Mali.
Anchor to MMMM: Myanmar (Burma).
Anchor to MNMN: Mongolia.
Anchor to MOMO: Macao SAR.
Anchor to MQMQ: Martinique.
Anchor to MRMR: Mauritania.
Anchor to MSMS: Montserrat.
Anchor to MTMT: Malta.
Anchor to MUMU: Mauritius.
Anchor to MVMV: Maldives.
Anchor to MWMW: Malawi.
Anchor to MXMX: Mexico.
Anchor to MYMY: Malaysia.
Anchor to MZMZ: Mozambique.
Anchor to NANA: Namibia.
Anchor to NCNC: New Caledonia.
Anchor to NENE: Niger.
Anchor to NFNF: Norfolk Island.
Anchor to NGNG: Nigeria.
Anchor to NINI: Nicaragua.
Anchor to NLNL: Netherlands.
Anchor to NONO: Norway.
Anchor to NPNP: Nepal.
Anchor to NRNR: Nauru.
Anchor to NUNU: Niue.
Anchor to NZNZ: New Zealand.
Anchor to OMOM: Oman.
Anchor to PAPA: Panama.
Anchor to PEPE: Peru.
Anchor to PFPF: French Polynesia.
Anchor to PGPG: Papua New Guinea.
Anchor to PHPH: Philippines.
Anchor to PKPK: Pakistan.
Anchor to PLPL: Poland.
Anchor to PMPM: St. Pierre & Miquelon.
Anchor to PNPN: Pitcairn Islands.
Anchor to PSPS: Palestinian Territories.
Anchor to PTPT: Portugal.
Anchor to PYPY: Paraguay.
Anchor to QAQA: Qatar.
Anchor to RERE: Réunion.
Anchor to RORO: Romania.
Anchor to RSRS: Serbia.
Anchor to RURU: Russia.
Anchor to RWRW: Rwanda.
Anchor to SASA: Saudi Arabia.
Anchor to SBSB: Solomon Islands.
Anchor to SCSC: Seychelles.
Anchor to SDSD: Sudan.
Anchor to SESE: Sweden.
Anchor to SGSG: Singapore.
Anchor to SHSH: St. Helena.
Anchor to SISI: Slovenia.
Anchor to SJSJ: Svalbard & Jan Mayen.
Anchor to SKSK: Slovakia.
Anchor to SLSL: Sierra Leone.
Anchor to SMSM: San Marino.
Anchor to SNSN: Senegal.
Anchor to SOSO: Somalia.
Anchor to SRSR: Suriname.
Anchor to SSSS: South Sudan.
Anchor to STST: São Tomé & Príncipe.
Anchor to SVSV: El Salvador.
Anchor to SXSX: Sint Maarten.
Anchor to SYSY: Syria.
Anchor to SZSZ: Eswatini.
Anchor to TATA: Tristan da Cunha.
Anchor to TCTC: Turks & Caicos Islands.
Anchor to TDTD: Chad.
Anchor to TFTF: French Southern Territories.
Anchor to TGTG: Togo.
Anchor to THTH: Thailand.
Anchor to TJTJ: Tajikistan.
Anchor to TKTK: Tokelau.
Anchor to TLTL: Timor-Leste.
Anchor to TMTM: Turkmenistan.
Anchor to TNTN: Tunisia.
Anchor to TOTO: Tonga.
Anchor to TRTR: Türkiye.
Anchor to TTTT: Trinidad & Tobago.
Anchor to TVTV: Tuvalu.
Anchor to TWTW: Taiwan.
Anchor to TZTZ: Tanzania.
Anchor to UAUA: Ukraine.
Anchor to UGUG: Uganda.
Anchor to UMUM: U.S. Outlying Islands.
Anchor to USUS: United States.
Anchor to UYUY: Uruguay.
Anchor to UZUZ: Uzbekistan.
Anchor to VAVA: Vatican City.
Anchor to VCVC: St. Vincent & Grenadines.
Anchor to VEVE: Venezuela.
Anchor to VGVG: British Virgin Islands.
Anchor to VNVN: Vietnam.
Anchor to VUVU: Vanuatu.
Anchor to WFWF: Wallis & Futuna.
Anchor to WSWS: Samoa.
Anchor to XKXK: Kosovo.
Anchor to YEYE: Yemen.
Anchor to YTYT: Mayotte.
Anchor to ZAZA: South Africa.
Anchor to ZMZM: Zambia.
Anchor to ZWZW: Zimbabwe.
Anchor to ZZZZ: Unknown Region.

Was this section helpful?

Anchor to FieldsFields

Anchor to CartBuyerIdentity.countryCode CartBuyerIdentity.countryCode •OBJECT: Contact information about the buyer interacting with a cart. The buyer's country determines international pricing and should match their shipping address.

For B2B scenarios, the purchasingCompany field identifies the company and location on whose behalf a business customer purchases. The preferences field stores delivery and wallet settings that prefill checkout fields to streamline the buying process.
Anchor to CartBuyerIdentityInput.countryCode CartBuyerIdentityInput.countryCode •INPUT OBJECT: The input fields for identifying the buyer associated with a cart. Buyer identity determines international pricing and should match the customer's shipping address.

Used by cartCreate and cartBuyerIdentityUpdate to set contact information, location, and checkout preferences.

Note
Preferences prefill fields at checkout but don't sync back to the cart if overwritten.
Note: Preferences prefill fields at checkout but don't sync back to the cart if overwritten.
Anchor to CartDeliveryAddressInput.countryCode CartDeliveryAddressInput.countryCode •INPUT OBJECT: The input fields to create or update a cart address.
Anchor to CartDeliveryCoordinatesPreference.countryCode CartDeliveryCoordinatesPreference.countryCode •OBJECT: Preferred location used to find the closest pick up point based on coordinates.
Anchor to CartDeliveryCoordinatesPreferenceInput.countryCode CartDeliveryCoordinatesPreferenceInput.countryCode •INPUT OBJECT: Preferred location used to find the closest pick up point based on coordinates.
Anchor to Country.isoCode Country.isoCode •OBJECT: A country with localization settings for a storefront. Includes the country's currency, available languages, default language, and unit system (metric or imperial).

Access countries through the localization query, which returns both the list of available countries and the currently active country. Use the @inContext directive to change the active country context.
Anchor to MailingAddress.countryCodeV2 MailingAddress.countryCodeV2 •OBJECT: A physical mailing address associated with a Customer or Order. Stores standard address components including street address, city, province, country, and postal code, along with customer name and company information.

The address includes geographic coordinates and provides pre-formatted output through the formatted field, which can optionally include or exclude name and company details.
Anchor to PaymentSettings.countryCode PaymentSettings.countryCode •OBJECT: Settings related to payments.
Anchor to Shop.shipsToCountries Shop.shipsToCountries •OBJECT: The central hub for store-wide settings and information accessible through the Storefront API. Provides the shop's name, description, and branding configuration including logos and colors through the Brand object.

Access store policies such as privacy, refund, shipping, and terms of service via ShopPolicy, and the subscription policy via ShopPolicyWithDefault. PaymentSettings expose accepted card brands, supported digital wallets, and enabled presentment currencies. The object also includes the primary Domain, countries the shop ships to, ShopPayInstallmentsPricing, and SocialLoginProvider options for customer accounts.

Was this section helpful?