Appearance
Translate Option Sets
Translate an option set's texts from the option set editor, one option at a time or the whole set on one page.
Overview
Once translations are turned on, the option set editor has two ways to translate:
- Translate buttons on each option, value, item and field. Translate that one thing into every language at once
- The Translations page. Translate every text in the set into one language, with filters for what's missing or outdated
Both save the same translations, so use whichever suits the job.
The Translate Button
| Where | Button |
|---|---|
| Every option card | Translate, next to Advanced settings and Style settings |
| Heading, Modal, Slider, Date Range, Formula, HTML Block and Rich Text | Also in the header of the option's own settings section |
| Each value row (Dropdown, Radio, Checkbox, Buttons, Switch, Scrollable List, Swatch, Color Dropdown, Image Dropdown) | A small button showing only the progress |
| Each Accordion or Tabs item | One button per item |
| Each Short Text Group field | One button per field |
Font pickers have no value button, because font names aren't translated.
Progress
The button shows how many languages are fully translated, for example Translate (1/3). It turns green when every language is done. With only one language to translate into, there's no count.
Hover over the button to see which languages still need work, for example Missing: French and Italian or Outdated: German.
The Translate Modal
Click Translate to open the modal for that option, value, item or field.
- Each text is shown with its Original above it
- Below the original, there's one input per language, each with a status
- Type the translations
- Click Save
Statuses
| Status | Meaning |
|---|---|
| Translated | Translated from the current original text |
| Missing | No translation yet |
| Outdated | The original text changed after it was translated |
| Not enabled | The language was removed from your store in Shopify. You can only clear this translation |
With 4 or more languages, each text also shows a summary such as 2 missing · 1 outdated.
Outdated translations
A translation becomes Outdated when you change its original text, for example when you rename a value. You can:
- Type a new translation. It becomes Translated when you save
- Click Mark as up to date. Use this when the translation still fits, for example after fixing a typo in the original. The translation stays as it is and becomes Translated when you save. Click Undo to change your mind
Outdated labels aren't shown to shoppers
An outdated option label, value label or Short Text Group field label shows in your original wording until you update it. Other outdated texts keep showing the old translation. See What Shoppers See.
Shared options
If an option is used in more than one option set, the modal says so: This option is used in 3 option sets. Its translations apply to all of them.
When translations are saved
| What you're translating | When it saves |
|---|---|
| An option, value or item that's already saved | Right away, when you click Save in the modal. The option set's own Save isn't needed |
| A new option or value, or anything in a new option set | When you save the option set. The modal says These translations are saved when you save the option set. |
The original shown in the modal is the last saved text. If the option set has unsaved changes, the modal says Translations apply to the last saved text.
The Translations Page
The Translations page lists every text in the option set, for one language at a time.
- Open an option set
- Click Translate in the page actions at the top. You can also click Translate all options in this set at the bottom of the Translate modal
- Pick a Language
- Type the translations
- Click Save in the contextual save bar
| Control | What it does |
|---|---|
| Language | The language you're translating into |
| Search | Finds options and values by name, original text or translation |
| All / Missing / Outdated | Shows only the texts with that status |
| Progress | For example 12 of 20 translated |
| Refresh languages | Loads languages you just added in Shopify |
Your edits are kept when you switch languages, and one Save saves them all.
The Translate page action appears once the option set is saved. It isn't available while you're creating or duplicating a set.
Preview in Another Language
The option set editor's preview has a Preview language picker next to Manage preview. Pick a language to see the form as shoppers in that language see it, including unsaved translations. Languages not yet published in Shopify are marked Unpublished.
The picker shows a note when shoppers don't see translations yet, for example when Show translations on the storefront is off.
Copying, Renaming and Deleting
| You... | What happens to translations |
|---|---|
| Rename an option or value | Its translations become Outdated |
| Change any other original text | That text's translations become Outdated |
| Reorder options, values or items | Translations are kept |
| Delete a value or item | Its translations are deleted |
| Duplicate an option | The copy keeps its translations. Its label gets " (Copy)", so the label translations become Outdated until you update them or mark them up to date |
| Duplicate an option set | The new set uses the same options, so it shares their translations |
| Duplicate a Style preset | The copy keeps its translations |
| Change an option's type | Texts both types have, such as the label and help text, keep their translations. Value translations are lost |
Errors
| Message | What to do |
|---|---|
| Use 255 characters or fewer. (or another limit) | Shorten the translation. Limits are listed in What Can Be Translated |
| The original text is empty, so there's nothing to translate. | Add the original text first |
| This text no longer exists. Reload the page. | The text was removed. Reload the page |
| Translations couldn't be saved. Try again. | Click Save again |
Related
- Storefront Translations — setup, plan and what shoppers see
- What Can Be Translated
- Storefront & Style Texts
- Translating with AI