Support multiple languages on storefronts

You can use the Storefront API to support multiple languages on a storefront. This guide explains how to retrieve translated content and create a checkout in the customer's language with the Storefront API.

Requirements

Anchor link to section titled "Requirements"

You've completed the Getting started with the Storefront API guide.
You're familiar with querying products and collections.
You've created resources that can be translated in your store.
You've created translated content using the GraphQL Admin API.
You're using API version 2022-04 or higher.

Step 1: Retrieve available languages

Anchor link to section titled "Step 1: Retrieve available languages"

For each country context, the languages available are configured within the shop’s Markets settings. The following example shows how to access the list of available languages with the Localization object.

Step 2: Retrieve translations

Anchor link to section titled "Step 2: Retrieve translations"

To query translatable resources and return translated content, use the @inContext directive to contextualize any query in one of the shop’s available languages.

The following example returns the Spanish translations for a product's title, description, and options.

Step 3: Create a checkout in the customer’s language

Anchor link to section titled "Step 3: Create a checkout in the customer’s language"

The @inContext directive can also be used with the checkoutCreate mutation to set the checkout locale.

The following example creates a checkout that will load in Spanish when you redirect the customer to its webUrl.

Next steps

Anchor link to section titled "Next steps"

Learn how to query international prices for products and orders, and explicitly set the context of a cart and checkout.
Learn how to create and update a cart in Shopify with the Storefront API.
Retrieve metafields with the Storefront API to access additional information from different types of resources.
Learn how to manage customer accounts with the Storefront API.
Learn about the different tools that you can use to create unique buying experiences anywhere your customers are, including websites, apps, and video games.