You are browsing upcoming documentation for version 6.1 of OroCommerce, scheduled for release in 2025. 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 


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:




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


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


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


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


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


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


The date when the localization is created.


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.


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.