After July 2021, the 2.3.x release line no longer received quality updates or user guide updates. PHP 7.3 reached end of support in December 2021, and Adobe Commerce 2.3.x reached end of support in September 2022. We strongly recommend upgrading to Adobe Commerce 2.4.x to help maintain PCI compliance.

Adding a Language

This site contains archived merchant documentation for a version of Adobe Commerce and Magento Open Source that has reached end-of-support. The documentation available here is intended for historical reference only and is not maintained. The Adobe Commerce Merchant Documentation for current releases is published on the Adobe Experience League.

Most of the text that appears to be hard-coded on pages throughout your store can be instantly changed to a different language by changing the locale of the view. Changing the locale does not actually translate the text word-for-word, but simply references a different translation table that provides the interface text that is used throughout the store. The text that can be changed includes navigational titles, labels, buttons, and links such as My Cart and My Account. You can also use the Inline Translation tool to touch up text in the interface.

Language packs can be found under Translations & Localization on Magento Marketplace. New extensions are continually added to Marketplace, so check back often!

Step 1: Install a Language Pack

Follow the standard instructions to install the language pack extension. See General CLI installation in the Installation Guide.

Step 2: Create a Store View for the Language

  1. On the Admin sidebar, go to Stores > Settings > All Stores.

  2. Click Create Store View.

  3. Set the options for the new store view:

    • Store — Choose the store that is the parent of the view.

    • Name — Enter a name for the store view. For example: Portuguese.

      In the header of the store, the name appears in the language chooser.

    • Code — Enter a Code in lowercase characters to identify the view. For example: portuguese.

    • Status — To activate the view, set to Enabled.

    • Sort Order — (Optional) Enter a number to determine the sequence in which this view is listed with other views.

  4. When complete, click Save Store View.

Step 3: Change the Locale of the Store View

  1. On the Admin sidebar, go to Stores > Settings > Configuration.

  2. In the upper-left corner, set Store View to the specific view where the configuration is to apply.

  3. When prompted to confirm scope switching, click OK.

  4. Expand Expansion selector the Locale Options section.

  5. Clear the Use Website checkbox after the Locale field and set Locale to the language that you want to assign to the view.

    If there are several variations of the language available, make sure to choose the one for the specific region or dialect.

  6. When complete, click Save Config.

    After you change the language of the locale, the remaining content that you have created, including product names and descriptions, categories, CMS pages, and blocks must be translated separately for each store view.

© 2024 Adobe. All rights reserved.