Choose a version:

localization

query

Returns the shop's localization settings. Use this query to build country and language selectors for your storefront.

The country and language fields reflect the active localized experience. To change the context, use the @inContext directive with your desired country or language code.

Anchor to Possible returnsPossible returns

Anchor to LocalizationLocalization

•Localization!

Information about the shop's configured localized experiences, including available countries and languages. The country and language fields reflect the active localization context, which you can change using the @inContext directive on queries.

Use availableCountries to list all countries with enabled localized experiences, and availableLanguages to get languages available for the currently active country. Each Country includes its own currency, unit system, and available languages.

Anchor to availableCountriesavailableCountries •[Country!]! non-null: The list of countries with enabled localized experiences.
Anchor to availableLanguagesavailableLanguages •[Language!]! non-null: The list of languages available for the active country.
Anchor to countrycountry •Country! non-null: The country of the active localized experience. Use the @inContext directive to change this value.
Anchor to languagelanguage •Language! non-null: The language of the active localized experience. Use the @inContext directive to change this value.
Anchor to marketmarket •Market! non-nullDeprecated

Was this section helpful?

Examples

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

Description

This example shows how to load the countries a shop sells to and the supported languages for each country. Any option returned by the API can also be passed to the [`@inContext` directive](/api/storefront#directives) to load data for that country and language context.

Query

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

cURL

curl -X POST \
https://your-development-store.myshopify.com/api/2026-01/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 } } } }"
}'

React Router

import { unauthenticated } from "../shopify.server";

export const loader = async () => {
  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 json = await response.json();
  return json.data;
}

Node.js

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

{
  "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"
          }
        ]
      }
    ]
  }
}

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

Open in GraphiQL

import { unauthenticated } from "../shopify.server";

export const loader = async () => {

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 json = await response.json();

return json.data;

}

GQL

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

cURL

curl -X POST \
https://your-development-store.myshopify.com/api/2026-01/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 } } } }"
}'

React Router

import { unauthenticated } from "../shopify.server";

export const loader = async () => {
  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 json = await response.json();
  return json.data;
}

Node.js

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"

}

]

}

]

}