Skip to main content

Localization overview

The Localization app controls which languages your storefront supports and lets you manage the custom translation keys that those languages use.

N
Written by Niyaz

The Localization app controls which languages your storefront supports and lets you manage the custom translation keys that those languages use. The app menu has two items, Client Languages and Client constant keys. A Sync button appears on the Client Languages screen, the Client constant keys screen and the Create constant key screen. Localization changes reach a storefront only after synchronization for that client, with the client active in the Hub.

Client Languages

Client Languages determines which languages the storefront serves and which of them is the default. The screen has a Supported Languages group of checkboxes and a Default language group of radio buttons.

Client Languages screen with Supported Languages checkboxes, a Default language selector and a disabled Save button

The Client Languages warning states that removing a supported language permanently deletes all custom translations associated with that language. Set your supported languages before you assign custom translations or Content Ready Components.

Client constant keys

Client constant keys holds the storefront's custom translation keys.

The Client constant keys screen lists keys by name and has a Search field. Each key's translations are listed per language with Created at and Updated at timestamps. Selecting Add Constant Key on this screen opens the Create constant key screen. The Create constant key screen lists keys by name, each with an apply button, and keys that already exist show a disabled exists button.

Why the language set comes first

Supported languages come before assigning custom translations or Content Ready Components. The Client Languages screen states that assigning a new language automatically assigns corresponding translations to all custom constants.

Global changes and client overrides

A client-specific translation override keeps its own text when the global translation changes. A global edit reaches a client only when that client has no override for the translation key.

What Localization does not decide

Localization looks after the words your storefront displays and the languages it offers them in. Decisions about money and rules, such as the amounts customers pay, currency conversion, tax, legal obligations and business policy, are made outside Localization.

Related

Did this answer your question?