Important

You are browsing documentation for version 5.1 of OroCommerce, supported until March 2026. Read the documentation for version 6.0 (the latest LTS version) to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Configure Localizations in the Back-Office 

Hint

This section is part of the Localization and Translation concept guide that provides a general understanding of the localization and translation processes in OroCommerce.

Localization helps to bind the language and locale-specific formatting for smooth localization of the Oro system elements and messages visible to the user.

To enable easy inheritance from the parent or similar language, localizations may form groups organized as an ancestors tree, for example:

  • English

    • English (UK)

    • English (USA)

    • English (Canada)

To view all localizations, navigate to System > Localizations in the main menu.

Localizations grid

The following information about the localizations is available in the Localizations list:

Name

Description

NAME

The name of the localization that identifies settings for the particular locale. It is displayed in the back-office.

TITLE

The name of the localization set with a specific configuration displayed to the user in the storefront.

LANGUAGE

The target language of the UI elements displayed to the user in the storefront.

FORMATTING

The formatting style of the corresponding target language that is applied in the localized instance.

ENABLE RTL MODE

The option that defines whether Right-to-Left text direction is enabled

PARENT LOCALIZATION

Another localization that the current one should fall back to whenever a system element has no translation in the target language.

CREATED AT

The date when the localization is created.

UPDATED AT

The date when the localization is updated.

Manage Localizations 

Hover over the More Options menu to the right of the necessary localization:

  1. Click to view the localization details. Alternatively, click the corresponding item to open its details page.

  2. Click to edit the localization.

  3. Click to remove the localization from the list.

../../../../../_images/localizations_more_options.png

Create a New Localization 

Create a new localization with a specific configuration by clicking Create Localization in the top right.

Crete a new localization page

  1. Give the localization a meaningful name and a title. The name is displayed in the back-office while the corresponding title is used in the storefront.

An illustration of how localization name added to the back-office is displayed in the storefront.

  1. Select the target language from the list for this particular localization. Make sure to enable the required language as described in the Languages section to display it in the list of the available languages.

  2. Select the language formatting style.

  3. If the localization you are creating requires Right-to-Left text direction, select the checkbox for Enable RTL Mode.

  4. Select the parent localization from the available list. If no relations are set, the current localization inherits the English translation equivalents by default.

  5. Click Save in the top right.

Once the localization is configured, you need to enable it in the system configuration menu. Proceed to the Localization Settings section and follow the steps described in the guide.