--- 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: unstable api_name: storefront source_url: html: 'https://shopify.dev/docs/api/storefront/unstable/enums/CountryCode' md: 'https://shopify.dev/docs/api/storefront/unstable/enums/CountryCode.md' --- # 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/unstable/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/unstable/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/unstable/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/unstable/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/unstable/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/unstable/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/unstable/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/unstable/objects/PaymentSettings#field-PaymentSettings.fields.countryCode) OBJECT Settings related to payments. * [Shop.shipsToCountries](https://shopify.dev/docs/api/storefront/unstable/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. * [Shop​Address.countryCode](https://shopify.dev/docs/api/storefront/unstable/objects/ShopAddress#field-ShopAddress.fields.countryCode) OBJECT An address for a shop. * [Query​Root.deliveryEstimates(countryCode)](https://shopify.dev/docs/api/storefront/unstable/objects/QueryRoot#field-QueryRoot.fields.deliveryEstimates.arguments.countryCode) ARGUMENT The entry point for all Storefront API queries. Provides access to shop resources including products, collections, carts, and customer data, as well as content like articles and pages. This query acts as the public, top-level type from which all queries must start. Use individual queries like [`product`](https://shopify.dev/docs/api/storefront/current/queries/product) or [`collection`](https://shopify.dev/docs/api/storefront/current/queries/collection) to fetch specific resources by ID or handle. Use plural queries like [`products`](https://shopify.dev/docs/api/storefront/current/queries/products) or [`collections`](https://shopify.dev/docs/api/storefront/current/queries/collections) to retrieve paginated lists with optional filtering and sorting. The [`search`](https://shopify.dev/docs/api/storefront/current/queries/search) and [`predictiveSearch`](https://shopify.dev/docs/api/storefront/current/queries/predictiveSearch) queries enable storefront search functionality. Explore queries interactively with the [GraphiQL explorer and sample query kit](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/api-exploration). * [Query​Root.deliveryEstimatesForVariants(countryCode)](https://shopify.dev/docs/api/storefront/unstable/objects/QueryRoot#field-QueryRoot.fields.deliveryEstimatesForVariants.arguments.countryCode) ARGUMENT The entry point for all Storefront API queries. Provides access to shop resources including products, collections, carts, and customer data, as well as content like articles and pages. This query acts as the public, top-level type from which all queries must start. Use individual queries like [`product`](https://shopify.dev/docs/api/storefront/current/queries/product) or [`collection`](https://shopify.dev/docs/api/storefront/current/queries/collection) to fetch specific resources by ID or handle. Use plural queries like [`products`](https://shopify.dev/docs/api/storefront/current/queries/products) or [`collections`](https://shopify.dev/docs/api/storefront/current/queries/collections) to retrieve paginated lists with optional filtering and sorting. The [`search`](https://shopify.dev/docs/api/storefront/current/queries/search) and [`predictiveSearch`](https://shopify.dev/docs/api/storefront/current/queries/predictiveSearch) queries enable storefront search functionality. Explore queries interactively with the [GraphiQL explorer and sample query kit](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/api-exploration). * [delivery​Estimates.countryCode](https://shopify.dev/docs/api/storefront/unstable/queries/deliveryEstimates#arguments-countryCode) ARGUMENT * [delivery​Estimates​For​Variants.countryCode](https://shopify.dev/docs/api/storefront/unstable/queries/deliveryEstimatesForVariants#arguments-countryCode) ARGUMENT *** ## Map ### Fields with this enum * [Cart​Buyer​Identity.countryCode](https://shopify.dev/docs/api/storefront/unstable/objects/CartBuyerIdentity#field-CartBuyerIdentity.fields.countryCode) * [Cart​Delivery​Coordinates​Preference.countryCode](https://shopify.dev/docs/api/storefront/unstable/objects/CartDeliveryCoordinatesPreference#field-CartDeliveryCoordinatesPreference.fields.countryCode) * [Country.isoCode](https://shopify.dev/docs/api/storefront/unstable/objects/Country#field-Country.fields.isoCode) * [Mailing​Address.countryCodeV2](https://shopify.dev/docs/api/storefront/unstable/objects/MailingAddress#field-MailingAddress.fields.countryCodeV2) * [Payment​Settings.countryCode](https://shopify.dev/docs/api/storefront/unstable/objects/PaymentSettings#field-PaymentSettings.fields.countryCode) * [Shop.shipsToCountries](https://shopify.dev/docs/api/storefront/unstable/objects/Shop#field-Shop.fields.shipsToCountries) * [Shop​Address.countryCode](https://shopify.dev/docs/api/storefront/unstable/objects/ShopAddress#field-ShopAddress.fields.countryCode) ### Inputs with this enum * [Cart​Buyer​Identity​Input.countryCode](https://shopify.dev/docs/api/storefront/unstable/input-objects/CartBuyerIdentityInput#fields-countryCode) * [Cart​Delivery​Address​Input.countryCode](https://shopify.dev/docs/api/storefront/unstable/input-objects/CartDeliveryAddressInput#fields-countryCode) * [Cart​Delivery​Coordinates​Preference​Input.countryCode](https://shopify.dev/docs/api/storefront/unstable/input-objects/CartDeliveryCoordinatesPreferenceInput#fields-countryCode) ### Arguments with this enum * [Query​Root.deliveryEstimates(countryCode)](https://shopify.dev/docs/api/storefront/unstable/objects/QueryRoot#field-QueryRoot.fields.deliveryEstimates.arguments.countryCode) * [Query​Root.deliveryEstimatesForVariants(countryCode)](https://shopify.dev/docs/api/storefront/unstable/objects/QueryRoot#field-QueryRoot.fields.deliveryEstimatesForVariants.arguments.countryCode) * [delivery​Estimates.countryCode](https://shopify.dev/docs/api/storefront/unstable/queries/deliveryEstimates#arguments-countryCode) * [delivery​Estimates​For​Variants.countryCode](https://shopify.dev/docs/api/storefront/unstable/queries/deliveryEstimatesForVariants#arguments-countryCode)