Skip to main content
Before you can translate an option set, Customei needs to know which locales exist in your account. You configure them once at the account level; every option set picks up the list automatically.

​
Open the language settings

From the Customei sidebar go to Settings → Languages. You’ll see two sections:
  1. Default language — the language you author option sets in.
  2. Target languages — every other locale the storefront should render.

​
Pick a default language

The default language is the one you write originally. Every translatable string starts as the default-language version; everything else is a translation of the default. Pick the language you use in the admin (for most merchants, that’s English). To change the default later, see the Changing the default section below.
The default doesn’t have to be English. If your team writes copy in Vietnamese, set Vietnamese as the default and translate from Vietnamese to everything else — that’s often more accurate than writing in a second language first.

​
Add a target language

1

Click Add language

Customei shows a searchable dropdown of locales (en, fr, de, ja, vi, fr-CA, etc.).
2

Pick one

Use the two-letter code for a whole language (e.g. fr for all French speakers) or the full code for a region-specific variant (e.g. fr-CA).
3

Give it a label

The label shows up in the translation editor (e.g. “Français (Canada)”). You can rename anytime.
4

Save

Customei adds the locale. Every option set’s Translation tab gains a new column for this locale.
Adding a locale doesn’t create translations automatically — it just opens a column that’s initially empty. See Translate an option set to fill it.

​
Should I add fr or fr-CA or both?

  • Add fr if one French translation is good enough for all French speakers.
  • Add fr-CA only if you want Quebec-specific wording (currency formatting, local idioms) to override the generic French.
  • Add both if you want fr-CA overrides to cascade onto the generic fr for unset strings.
Customei picks the most specific match at runtime, then falls back.

​
Remove a target language

1

Click the language in the list

The settings drawer opens.
2

Click Remove

Customei warns you that existing translations in this locale will be archived.
3

Confirm

The locale disappears from every option set’s Translation tab. Translations are archived, not deleted — if you add the locale back within 90 days, you’ll get them back.

​
Changing the default

Changing the default language after you’ve already translated content is non-trivial — everything that was “source” becomes a “translation” and vice versa. Contact Support if you need to change the default; we’ll help you migrate without losing any work.

​
Permissions

Language settings are part of the Settings permission group. Specifically:
  • settings:view — read language config.
  • settings:edit — add, remove, or rename languages.
  • translation:edit — edit individual translations inside an option set.
See Roles and permissions.

​
Next