Add a new language to system settings

Current version: 9.1

Add a language to system settings

Before you can create a version of an item in a new language, you must add the new language in the Experience Manager system settings. Then the new language code and associated country/region code become available for configuration within Sitecore.

To add a language to system settings:

  1. In the Content Editor, go to /sitecore/System/Languages.

  2. Right-click and then click Insert, Language.

  3. In the Add a New Language dialog box, in the Choose a predefined language code field, select the language and country code you want to use.

  4. Complete the remaining fields as required and click Next to step through the remaining pages of the wizard.

    The Add a New Language dialog box in Sitecore Content Editor.
  5. When you are finished, click Close.

    The new language is added to the content tree.

Add a custom language

The system supports all the languages available in the .NET CultureInfo class. If you want to add a language that is not available in the default cultures, you first register a custom culture, then add it to the LanguageDefinitions.config file to make it available in the system settings.

When you add a new language in Sitecore system settings, the languages available in the drop-down menu of the Add a New Language dialog are determined by the list of languages in the LanguageDefinitions.config file. However, you also have the option of typing in the language manually in the system settings.

  1. Register a custom .NET culture by creating a simple console application, as explained in Microsoft documentation.

  2. Run the application once on each Sitecore environment server.

  3. Open the language config file under \App_Config\LanguageDefinitions.config.

  4. Add the language in the following format. The language definition must match the .NET custom culture.

    RequestResponse
    
     <language id="pt" region="MX" codepage="65001" encoding="utf-8" charset="iso-XXXX" icon="flags/16x16/flag_Mexic.PNG" />
    
  5. In the Content Editor, go to /sitecore/System/Languages.

  6. Right-click and then click Insert, Language.

  7. If you added the language to the config file, in the Add a New Language dialog box, in the Choose a predefined language code field, select the language and country code you want to use. Alternatively, type the language code manually. In both cases, the language code must match the registered custom culture.

  8. Complete the remaining fields as required and click Next to step through the remaining pages of the wizard.

  9. When you are finished, click Close. The new language is added to the content tree.

Do you have some feedback for us?

If you have suggestions for improving this article,