Skip to content

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 ​

WhereButton
Every option cardTranslate, next to Advanced settings and Style settings
Heading, Modal, Slider, Date Range, Formula, HTML Block and Rich TextAlso 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 itemOne button per item
Each Short Text Group fieldOne 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.

  1. Each text is shown with its Original above it
  2. Below the original, there's one input per language, each with a status
  3. Type the translations
  4. Click Save

Statuses ​

StatusMeaning
TranslatedTranslated from the current original text
MissingNo translation yet
OutdatedThe original text changed after it was translated
Not enabledThe 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 translatingWhen it saves
An option, value or item that's already savedRight 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 setWhen 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.

  1. Open an option set
  2. 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
  3. Pick a Language
  4. Type the translations
  5. Click Save in the contextual save bar
ControlWhat it does
LanguageThe language you're translating into
SearchFinds options and values by name, original text or translation
All / Missing / OutdatedShows only the texts with that status
ProgressFor example 12 of 20 translated
Refresh languagesLoads 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 valueIts translations become Outdated
Change any other original textThat text's translations become Outdated
Reorder options, values or itemsTranslations are kept
Delete a value or itemIts translations are deleted
Duplicate an optionThe 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 setThe new set uses the same options, so it shares their translations
Duplicate a Style presetThe copy keeps its translations
Change an option's typeTexts both types have, such as the label and help text, keep their translations. Value translations are lost

Errors ​

MessageWhat 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