Translating content for an online store

This tutorial has the following requirements:

• a Shopify store or development store
• at least one product in your store

Install the Shopify GraphiQL app on your store. You can use the Shopify GraphiQL app to build and execute GraphQL queries and mutations on your store. When installing the GraphiQL app, make sure that you enable the translations and locales write access scope.

Use the shopLocaleEnable mutation to enable the es locale on your store. In the shopLocale response, include the locale, name, and published fields to verify that the locale has been successfully enabled.

By default, newly enabled locales are not published.

Run in GraphiQL

To retrieve the first product eligible for translation, use the translatableResources query with the parameters first: 1 and resourceType: PRODUCT. In the translatableContent response, include the key, value, digest, and locale fields. You need their response values to write the translation in the next step.

Run in GraphiQL

Use the translationsRegister mutation to create a new translation for a translatable resource. When you create a translation, you need to include the translatable content's digest value in the translatableContentDigest field. A unique digest is returned from the translatableResources query for each translatableContent entry.

Run in GraphiQL

You can publish a locale from the Shopify admin or by using the GraphQL Admin API. To learn more about publishing locales with the API, refer to Managing shop locales. Shops are limited to 20 published locales.

1. In your development store's Shopify admin, go to Settings > Store Languages.

2. In the Translated Languages section, click Publish next to the Spanish locale.

To view the translation, navigate to the product's page on your online store. Make sure you add an es to your URL, for example, myshopifystore.com/es/products/great-shirt.

• Shop locales
• Multi-language translation