Configure Localization Settings per Organization 


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

To define the custom localization options for a particular organization:

  1. Navigate to System > User management > Organizations in the main menu.

  2. For the necessary organization, hover over the More Options menu to the right and click to start editing the configuration.

  3. Select System Configuration > General Setup > Localization in the menu to the left.


    For faster navigation between the configuration menu sections, use Quick Search.

    Localization configuration options per organization

    Here, you can configure the following options by clearing the Use System checkbox and providing your own data.

  4. In the Location Options section, provide:

    • Primary Location and Format Address Per Country — Define the address formatting to be applied.

      If Format Address Per Country is enabled and the country-specific formatting is enabled for the instance, the address will be displayed in compliance with the rules specified for the country. For example, if the chosen country is China, the address is displayed as follows:

      • ZIP code

      • Country

      • State, City

      • Street

      • First and Last name

      whereas, for the US it is:

      • First and Last name

      • Street name


      Otherwise, the Primary Location formatting is applied.

    • Timezone — Defines the timezone to be applied for all the time settings defined in the instance. If the time-zone is changed, all the time settings (e.g. due dates of tasks), time of reminders, etc. change correspondingly. The default value is(UTC -08:00) America/Los Angeles.

    • First Quarter Starts On — Defines the quarter start date. The default value is January, 1.

    • Currency — Select the default currency for the current organization.

  5. In the Map Settings, select the Temperature Unit and Wind Speed Unit to display the weather on the map. The default values are Fahrenheit and miles per hour (MPH).

    Weather on a map
  6. In the Localization Settings, provide:

    • Default Localization — The default language of the back-office and storefront UI for the current organization. The list of available languages depends on the localizations added to the Enabled Localizations list on the global level.

    • Enabled Localizations — The list of localizations is generated automatically based on the data preconfigured in the System > Localization > Localizations menu.

      All supported localizations added to this list are displayed in the language switcher in the storefront.

      Language switcher in the storefront

      In addition, they determine the languages available for the email notifications. If there is an email template for the supported language, the users who have selected that specific language in the storefront, receive localized notifications.

      Language tabs in email templates
  7. Click Save Settings.