Adding a Language

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 Commerce 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. For detailed information about installing an extension, see General CLI installation in the Extensions 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.