Add a language version to an existing storefront site

Current version: 10.2

The Commerce Control Panel in Sitecore Content Editor defines the Default language set that includes English, German (De), Japanese (Ja), and French (Fr). By default, the storefront site language is English.

You can add more languages to an existing language set or create a new set all together. You can also remove languages that are not required.

Important

Sitecore indexes content items in every language that is included in the language set assigned to the storefront. It is best practice to remove unnecessary languages from the language set to help optimize indexing performance and reduce the size of the indexes.

To add a language to the storefront site:

  1. Add the new language to the Sitecore system settings (/sitecore/System/Languages).

  2. In the content tree, go to /sitecore/Commerce/Commerce Control Panel/Shared Settings/Language Sets and select the set used by the storefront site.

  3. In the Languages section, double-click the new language to move it to the Selected list, add it to Commerce Control Panel, and save your changes.

    Note

    Language sets can be shared between storefronts so make sure you are not adding a language to other storefronts as well unless this is intended. To use different languages on different storefront sites, you must create distinct language sets, and assign the appropriate language set to each storefront based on the language requirements of each site.

    Commerce Control Panel - Languages
    Warning

    As soon as the Commerce Control Panel settings are published, the new language is available from the language selector on the storefront.

  4. In the Content Editor, go to /sitecore/Commerce/Commerce Control Panel/Storefront Settings/Storefronts/<site>/Language Configuration and configure the storefront to use the language set with the new language.

  5. When a storefront site is created, it only has items with an English language version so you must add a language version to the content of the storefront site to support the new language.

    Each version of a Sitecore item can have its own translated text. For smaller sites, you can enter translated text on the Content tab. For more extensive translations, you can export the language to an XML file using the Localization settings in the Control Panel.

Warning

Any changes or additions that you make to the site have to be replicated in each language version. For example, if you add a component to the English version of a page, no change is made automatically to the other versions of the page - you must add the component to each version. Default translations are included with the component, but if you make changes to the English text, you must translate the changes.

Remove a language from a language set

You can remove unnecessary languages from a language set. It is best practice to remove unnecessary languages from the language set to help optimize indexing performance, and reduce the size of the indexes.

To remove a language from a language set:

  1. In the Content Editor, in the content tree, go to /sitecore/Commerce/Commerce Control Panel/Shared Settings/Language Sets, and select the set used by the storefront site.

  2. In the Languages section, in the Selected list, double-click the language to remove. The language is removed from the list.

  3. Click Save.

  4. Publish your change. In the content tree, right-click the /sitecore/Commerce/Commerce Control Panel/Share Settings folder, and then click Publish Item.

  5. Clear the Commerce cache. Click the Commerce tab, click Refresh Commerce Cache.

  6. Browse to the storefront and use the language selector to confirm that the language is removed.

Do you have some feedback for us?

If you have suggestions for improving this article,