Choose a version:

localization

query

Returns the localized experiences configured for the shop.

Anchor to Possible returnsPossible returns

Anchor to LocalizationLocalization •Localization!: Information about the localized experiences configured for the shop.

Was this section helpful?

Load the countries a shop sells to and the supported languages for each

Open in GraphiQL

const { storefront } = await unauthenticated.storefront(

'your-development-store.myshopify.com'

);

const response = await storefront.graphql(

`#graphql

query AllLocalizations @inContext(language: EN) {

localization {

availableCountries {

isoCode

name

availableLanguages {

isoCode

endonymName

}

}`,

);

const data = await response.json();

query AllLocalizations @inContext(language: EN) {
  localization {
    availableCountries {
      isoCode
      name
      availableLanguages {
        isoCode
        endonymName
      }
    }
  }
}

curl -X POST \
https://your-development-store.myshopify.com/api/2025-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Storefront-Access-Token: {storefront_access_token}' \
-d '{
"query": "query AllLocalizations @inContext(language: EN) { localization { availableCountries { isoCode name availableLanguages { isoCode endonymName } } } }"
}'

const { storefront } = await unauthenticated.storefront(
  'your-development-store.myshopify.com'
);

const response = await storefront.graphql(
  `#graphql
  query AllLocalizations @inContext(language: EN) {
    localization {
      availableCountries {
        isoCode
        name
        availableLanguages {
          isoCode
          endonymName
        }
      }
    }
  }`,
);

const data = await response.json();

const client = new shopify.clients.Storefront({
  domain: 'your-development-store.myshopify.com',
  storefrontAccessToken,
});
const data = await client.query({
  data: `query AllLocalizations @inContext(language: EN) {
    localization {
      availableCountries {
        isoCode
        name
        availableLanguages {
          isoCode
          endonymName
        }
      }
    }
  }`,
});

Response

JSON

{

"localization": {

"availableCountries": [

{

"isoCode": "BE",

"name": "Belgium",

"availableLanguages": [

{

"isoCode": "EN",

"endonymName": "English"

{

"isoCode": "ES",

"endonymName": "Español"

{

"isoCode": "FR",

"endonymName": "Français"

}

]

{

"isoCode": "CA",

"name": "Canada",

"availableLanguages": [

{

"isoCode": "EN",

"endonymName": "English"

{

"isoCode": "FR",

"endonymName": "Français"

}

]

{

"isoCode": "DE",

"name": "Germany",

"availableLanguages": [

{

"isoCode": "EN",

"endonymName": "English"

{

"isoCode": "ES",

"endonymName": "Español"

{

"isoCode": "FR",

"endonymName": "Français"

}

]

{

"isoCode": "ES",

"name": "Spain",

"availableLanguages": [

{

"isoCode": "EN",

"endonymName": "English"

{

"isoCode": "ES",

"endonymName": "Español"

{

"isoCode": "FR",

"endonymName": "Français"

}

]

{

"isoCode": "FR",

"name": "France",

"availableLanguages": [

{

"isoCode": "EN",

"endonymName": "English"

{

"isoCode": "ES",

"endonymName": "Español"

{

"isoCode": "FR",

"endonymName": "Français"

}

]

{

"isoCode": "GB",

"name": "United Kingdom",

"availableLanguages": [

{

"isoCode": "EN",

"endonymName": "English"

}

]

{

"isoCode": "US",

"name": "United States",

"availableLanguages": [

{

"isoCode": "EN",

"endonymName": "English"

{

"isoCode": "ES",

"endonymName": "Español"

}

]

}

]

}