--- title: CountryCode - Storefront API description: >- 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`. api_version: 2026-10 source_url: html: 'https://shopify.dev/docs/api/storefront/latest/enums/CountryCode' md: 'https://shopify.dev/docs/api/storefront/latest/enums/CountryCode.md' api_name: storefront api_type: graphql type: enum --- # Country​Code 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`. ## Valid values * AC Ascension Island. * AD Andorra. * AE United Arab Emirates. * AF Afghanistan. * AG Antigua & Barbuda. * AI Anguilla. * AL Albania. * AM Armenia. * AN Netherlands Antilles. * AO Angola. * AR Argentina. * 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. * 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. * GW Guinea-Bissau. * GY Guyana. * HK Hong Kong SAR. * 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. * MK North Macedonia. * ML Mali. * MM Myanmar (Burma). * MN Mongolia. * MO Macao SAR. * 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. * PS Palestinian Territories. * PT Portugal. * 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. * TA Tristan da Cunha. * 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. * VN Vietnam. * VU Vanuatu. * WF Wallis & Futuna. * WS Samoa. * XK Kosovo. * YE Yemen. * YT Mayotte. * ZA South Africa. * ZM Zambia. * ZW Zimbabwe. * ZZ Unknown Region. *** ## Fields * [Cart​Buyer​Identity.countryCode](https://shopify.dev/docs/api/storefront/latest/objects/CartBuyerIdentity#field-CartBuyerIdentity.fields.countryCode) OBJECT Contact information about the buyer interacting with a [cart](https://shopify.dev/docs/api/storefront/current/objects/Cart). The buyer's country determines [international pricing](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/markets/international-pricing) and should match their shipping address. For B2B scenarios, the [`purchasingCompany`](https://shopify.dev/docs/api/storefront/current/objects/CartBuyerIdentity#field-CartBuyerIdentity.fields.purchasingCompany) field identifies the company and location on whose behalf a business customer purchases. The [`preferences`](https://shopify.dev/docs/api/storefront/current/objects/CartBuyerIdentity#field-CartBuyerIdentity.fields.preferences) field stores delivery and wallet settings that prefill checkout fields to streamline the buying process. * [Cart​Buyer​Identity​Input.countryCode](https://shopify.dev/docs/api/storefront/latest/input-objects/CartBuyerIdentityInput#fields-countryCode) INPUT OBJECT The input fields for identifying the buyer associated with a cart. Buyer identity determines [international pricing](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/markets/international-pricing) and should match the customer's shipping address. Used by [`cartCreate`](https://shopify.dev/docs/api/storefront/current/mutations/cartCreate) and [`cartBuyerIdentityUpdate`](https://shopify.dev/docs/api/storefront/current/mutations/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. *** * [Cart​Delivery​Address​Input.countryCode](https://shopify.dev/docs/api/storefront/latest/input-objects/CartDeliveryAddressInput#fields-countryCode) INPUT OBJECT The input fields to create or update a cart address. * [Cart​Delivery​Coordinates​Preference.countryCode](https://shopify.dev/docs/api/storefront/latest/objects/CartDeliveryCoordinatesPreference#field-CartDeliveryCoordinatesPreference.fields.countryCode) OBJECT Preferred location used to find the closest pick up point based on coordinates. * [Cart​Delivery​Coordinates​Preference​Input.countryCode](https://shopify.dev/docs/api/storefront/latest/input-objects/CartDeliveryCoordinatesPreferenceInput#fields-countryCode) INPUT OBJECT Preferred location used to find the closest pick up point based on coordinates. * [Country.isoCode](https://shopify.dev/docs/api/storefront/latest/objects/Country#field-Country.fields.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](https://shopify.dev/docs/api/storefront/current/queries/localization) query, which returns both the list of available countries and the currently active country. Use the [`@inContext`](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/in-context) directive to change the active country context. * [Mailing​Address.countryCodeV2](https://shopify.dev/docs/api/storefront/latest/objects/MailingAddress#field-MailingAddress.fields.countryCodeV2) OBJECT A physical mailing address associated with a [`Customer`](https://shopify.dev/docs/api/storefront/current/objects/Customer) or [`Order`](https://shopify.dev/docs/api/storefront/current/objects/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`](https://shopify.dev/docs/api/storefront/current/objects/MailingAddress#field-MailingAddress.fields.formatted) field, which can optionally include or exclude name and company details. * [Payment​Settings.countryCode](https://shopify.dev/docs/api/storefront/latest/objects/PaymentSettings#field-PaymentSettings.fields.countryCode) OBJECT Settings related to payments. * [Shop.shipsToCountries](https://shopify.dev/docs/api/storefront/latest/objects/Shop#field-Shop.fields.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`](https://shopify.dev/docs/api/storefront/current/objects/Brand) object. Access store policies such as privacy, refund, shipping, and terms of service via [`ShopPolicy`](https://shopify.dev/docs/api/storefront/current/objects/ShopPolicy), and the subscription policy via [`ShopPolicyWithDefault`](https://shopify.dev/docs/api/storefront/current/objects/ShopPolicyWithDefault). [`PaymentSettings`](https://shopify.dev/docs/api/storefront/current/objects/PaymentSettings) expose accepted card brands, supported digital wallets, and enabled presentment currencies. The object also includes the primary [`Domain`](https://shopify.dev/docs/api/storefront/current/objects/Domain), countries the shop ships to, [`ShopPayInstallmentsPricing`](https://shopify.dev/docs/api/storefront/current/objects/ShopPayInstallmentsPricing), and [`SocialLoginProvider`](https://shopify.dev/docs/api/storefront/current/objects/SocialLoginProvider) options for customer accounts. *** ## Map ### Fields with this enum * [Cart​Buyer​Identity.countryCode](https://shopify.dev/docs/api/storefront/latest/objects/CartBuyerIdentity#field-CartBuyerIdentity.fields.countryCode) * [Cart​Delivery​Coordinates​Preference.countryCode](https://shopify.dev/docs/api/storefront/latest/objects/CartDeliveryCoordinatesPreference#field-CartDeliveryCoordinatesPreference.fields.countryCode) * [Country.isoCode](https://shopify.dev/docs/api/storefront/latest/objects/Country#field-Country.fields.isoCode) * [Mailing​Address.countryCodeV2](https://shopify.dev/docs/api/storefront/latest/objects/MailingAddress#field-MailingAddress.fields.countryCodeV2) * [Payment​Settings.countryCode](https://shopify.dev/docs/api/storefront/latest/objects/PaymentSettings#field-PaymentSettings.fields.countryCode) * [Shop.shipsToCountries](https://shopify.dev/docs/api/storefront/latest/objects/Shop#field-Shop.fields.shipsToCountries) ### Inputs with this enum * [Cart​Buyer​Identity​Input.countryCode](https://shopify.dev/docs/api/storefront/latest/input-objects/CartBuyerIdentityInput#fields-countryCode) * [Cart​Delivery​Address​Input.countryCode](https://shopify.dev/docs/api/storefront/latest/input-objects/CartDeliveryAddressInput#fields-countryCode) * [Cart​Delivery​Coordinates​Preference​Input.countryCode](https://shopify.dev/docs/api/storefront/latest/input-objects/CartDeliveryCoordinatesPreferenceInput#fields-countryCode)