Appearance
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
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
- Navigate to App Settings > Storefront Settings
- Open Storefront translations
- Tick Turn on translations
- 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.
- Click Allow access (on the Translations page, Load languages)
- 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:
- Navigate to App Settings > Storefront Settings > Storefront translations
- Tick Show translations on the storefront
- 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
- Your plan includes storefront translations
- Turn on translations is ticked
- 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 see | What it means | What to do |
|---|---|---|
| Allow access to your store languages | The app can't read your languages yet, or access was removed | Click Allow access and approve Shopify's prompt |
| Access wasn't granted. You can allow it any time. | You declined Shopify's prompt | Click Allow access again |
| Add a language to your store | Your store has only one language | Click Manage languages in Shopify, add a language, then click Refresh languages |
| Your store languages couldn't be updated | The app couldn't reach Shopify | Click 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.
| Situation | Shopper sees |
|---|---|
| A translation exists for the shopper's language | The translation |
| No translation for a regional language, but one for its base language | The base language's translation. For example, a French translation is also shown on French (Canada) |
| No translation | Your 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
| Problem | What to do |
|---|---|
| There are no Translate buttons | Tick Turn on translations in Storefront Settings > Storefront translations |
| Translations don't show on the storefront | Tick Show translations on the storefront, and check your plan includes storefront translations |
| A label shows in the original language | Its translation may be Outdated. Update it or click Mark as up to date |
| A new Shopify language is missing | Click Refresh languages on the option set's Translations page |
| Shoppers can't pick a language | Publish it in Shopify under Settings > Languages |
| Translate inputs are read-only | Your plan doesn't include storefront translations. You can still see existing translations |
Related
- Translate Option Sets — the Translate button, statuses and the Translations page
- What Can Be Translated — every translatable text, per option type
- Storefront & Style Texts — storefront messages and preset texts
- Storefront Translations settings
- Translating with AI