---
title: Localization - Storefront API
description: >-
  Information about the shop's configured localized experiences, including

  available countries and languages. The
  [`country`](/docs/api/storefront/2026-10/objects/Localization#field-Localization.fields.country)
  and
  [`language`](/docs/api/storefront/2026-10/objects/Localization#field-Localization.fields.language)

  fields reflect the active localization context, which you can change using the

  `@inContext` directive on queries.


  Use
  [`availableCountries`](/docs/api/storefront/2026-10/objects/Localization#field-Localization.fields.availableCountries)
  to list all countries with enabled localized experiences, and
  [`availableLanguages`](/docs/api/storefront/2026-10/objects/Localization#field-Localization.fields.availableLanguages)

  to get languages available for the currently active country. Each

  [`Country`](/docs/api/storefront/2026-10/objects/Country)

  includes its own currency, unit system, and available languages.
api_version: 2026-10
source_url:
  html: 'https://shopify.dev/docs/api/storefront/latest/objects/Localization'
  md: 'https://shopify.dev/docs/api/storefront/latest/objects/Localization.md'
api_name: storefront
api_type: graphql
type: object
---

# Localization

object

Information about the shop's configured localized experiences, including available countries and languages. The [`country`](https://shopify.dev/docs/api/storefront/2026-10/objects/Localization#field-Localization.fields.country) and [`language`](https://shopify.dev/docs/api/storefront/2026-10/objects/Localization#field-Localization.fields.language) fields reflect the active localization context, which you can change using the `@inContext` directive on queries.

Use [`availableCountries`](https://shopify.dev/docs/api/storefront/2026-10/objects/Localization#field-Localization.fields.availableCountries) to list all countries with enabled localized experiences, and [`availableLanguages`](https://shopify.dev/docs/api/storefront/2026-10/objects/Localization#field-Localization.fields.availableLanguages) to get languages available for the currently active country. Each [`Country`](https://shopify.dev/docs/api/storefront/2026-10/objects/Country) includes its own currency, unit system, and available languages.

## Fields

* available​Countries

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

  non-null

  The list of countries with enabled localized experiences.

* available​Languages

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

  non-null

  The list of languages available for the active country.

* country

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

  non-null

  The country of the active localized experience. Use the `@inContext` directive to change this value.

* language

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

  non-null

  The language of the active localized experience. Use the `@inContext` directive to change this value.

* market

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

  non-nullDeprecated

***

## Map

No referencing types

***

## Queries

* [localization](https://shopify.dev/docs/api/storefront/latest/queries/localization)

  query

  Returns the shop's localization settings. Use this query to build [country and language selectors](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/markets) for your storefront.

  The [`country`](https://shopify.dev/docs/api/storefront/latest/queries/localization#returns-Localization.fields.country) and [`language`](https://shopify.dev/docs/api/storefront/latest/queries/localization#returns-Localization.fields.language) fields reflect the active localized experience. To change the context, use the [`@inContext`](https://shopify.dev/docs/api/storefront#directives) directive with your desired country or language code.

***

## Localization Queries

### Queried by

* [localization](https://shopify.dev/docs/api/storefront/latest/queries/localization)