Skip to content

Storefront Translations ​

Show your option texts in each shopper's own language: option labels, values, help text, placeholders, headings and more.

Overview ​

If your store sells in more than one language, shoppers browsing in another language see your options in that language. You translate the texts once in the option set editor, and the app shows the right language to each shopper.

What you can translate:

  • Option texts in every option set: labels, values, help text, placeholders, headings, item titles and content, units and more. See What Can Be Translated
  • Your storefront messages, such as "{option} is required" and the Edit in cart buttons, and some texts in your Style presets. See Storefront & Style Texts

Where you translate:

  • A Translate button on every option, value, Accordion or Tabs item and Short Text Group field
  • A full Translations page per option set, one language at a time
  • A Translations row under each storefront message and preset text

See Translate Option Sets.

Prefer to have AI do it?

An AI assistant connected to your store can find missing translations and translate whole option sets for you. See Translating with AI.

Plan ​

Storefront translations are included in the Premium plan. Without it, the settings show a Premium badge and a View plans button, translations can't be saved, and shoppers see your original text.

If your plan changes, your translations are kept. Shoppers see the original text until the plan includes translations again.

Storefront messages that still use the app's built-in wording are translated for free on every plan. See Built-in texts.

Set Up Translations ​

1. Add a language in Shopify ​

In your Shopify admin, go to Settings > Languages, add a language (for example German) and publish it.

You can translate into unpublished languages too, so you can prepare translations first. Shoppers can only pick a published language.

2. Turn on translations in the app ​

  1. Navigate to App Settings > Storefront Settings
  2. Open Storefront translations
  3. Tick Turn on translations
  4. Click Save in the contextual save bar

This shows the translation tools in the app. It doesn't show anything to shoppers yet. See Storefront Translations settings.

3. Allow access to your store languages ​

The first time you click a Translate button, the app asks to Allow access to your store languages. It needs to read which languages your store uses.

  1. Click Allow access (on the Translations page, Load languages)
  2. Approve Shopify's permission prompt

The app then loads your store's languages. If you decline, nothing can be translated. The same button asks again whenever you're ready.

4. Translate your texts ​

Use the Translate buttons in the option set editor, or the option set's Translations page. See Translate Option Sets.

5. Show translations to shoppers ​

When your translations are ready:

  1. Navigate to App Settings > Storefront Settings > Storefront translations
  2. Tick Show translations on the storefront
  3. Click Save

Until you do, the app shows Translations are not shown to shoppers yet on the translation screens.

Shoppers see translations only when all three are on

  1. Your plan includes storefront translations
  2. Turn on translations is ticked
  3. Show translations on the storefront is ticked

Your Store Languages ​

The app translates into every language you've added in Shopify, except your store's main language.

What you seeWhat it meansWhat to do
Allow access to your store languagesThe app can't read your languages yet, or access was removedClick Allow access and approve Shopify's prompt
Access wasn't granted. You can allow it any time.You declined Shopify's promptClick Allow access again
Add a language to your storeYour store has only one languageClick Manage languages in Shopify, add a language, then click Refresh languages
Your store languages couldn't be updatedThe app couldn't reach ShopifyClick Try again

Added a language in Shopify? It appears in the app within about 10 minutes. To see it right away, open an option set's Translations page and click Refresh languages.

Removed a language in Shopify? Its translations are kept but no longer shown to shoppers. In the app they show as Not enabled, and you can only clear them.

What Shoppers See ​

The app shows each shopper the language Shopify picked for them, for example on /fr/products/... or on a French market domain. You don't need to set anything up for this.

SituationShopper sees
A translation exists for the shopper's languageThe translation
No translation for a regional language, but one for its base languageThe base language's translation. For example, a French translation is also shown on French (Canada)
No translationYour original text
The translation is Outdated (the original changed after you translated it)Option labels, value labels and Short Text Group field labels: your original text. Every other text: the old translation, until you update it

Test it in another language

Change the language part of your product URL. For example, your-store.myshopify.com/products/t-shirt becomes your-store.myshopify.com/de/products/t-shirt for German. You can also use the Preview language picker in the option set editor's preview.

Cart and orders ​

  • Values are translated. Value labels, Short Text Group field labels and Slider and Formula units appear in the cart in the shopper's language
  • Option names stay in your original wording. The cart property name is always your original label, so a German shopper's line reads, for example, Color: Schwarz
  • Edit in cart works in every language. The Edit in cart button and modal labels can be translated as storefront texts

Troubleshooting ​

ProblemWhat to do
There are no Translate buttonsTick Turn on translations in Storefront Settings > Storefront translations
Translations don't show on the storefrontTick Show translations on the storefront, and check your plan includes storefront translations
A label shows in the original languageIts translation may be Outdated. Update it or click Mark as up to date
A new Shopify language is missingClick Refresh languages on the option set's Translations page
Shoppers can't pick a languagePublish it in Shopify under Settings > Languages
Translate inputs are read-onlyYour plan doesn't include storefront translations. You can still see existing translations