---
title: localization - Storefront API
description: Returns the localized experiences configured for the shop.
api_version: 2025-10
api_name: storefront
type: query
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/storefront/latest/queries/localization
  md: https://shopify.dev/docs/api/storefront/latest/queries/localization.md
---

# localization

query

Returns the localized experiences configured for the shop.

## Possible returns

* Localization

  [Localization!](https://shopify.dev/docs/api/storefront/latest/objects/Localization)

  Information about the localized experiences configured for the shop.

***

## 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

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

  #### cURL

  ```bash
  curl -X POST \
  https://your-development-store.myshopify.com/api/2025-10/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

  ```javascript
  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

  ```javascript
  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"
            }
          ]
        }
      ]
    }
  }
  ```

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

[Open in GraphiQL](http://localhost:3457/graphiql?query=query%20AllLocalizations%20%40inContext\(language%3A%20EN\)%20%7B%0A%20%20localization%20%7B%0A%20%20%20%20availableCountries%20%7B%0A%20%20%20%20%20%20isoCode%0A%20%20%20%20%20%20name%0A%20%20%20%20%20%20availableLanguages%20%7B%0A%20%20%20%20%20%20%20%20isoCode%0A%20%20%20%20%20%20%20%20endonymName%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D)

```javascript
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/2025-10/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

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