Adding languages

This topic describes how to add a new language (custom culture) that does not appear in the list of available languages in the Manage Website Languages section in admin view. This is useful when you want to add less commonly-used language and local combinations on an Episerver CMS installation.

Note: Custom cultures such as ”en-gb”, “en-us”, and ”fr-ca”, are currently not supported for solutions running in Episerver Customer-Centric Digital Experience Platform (DXP). See Multisite development for more information.

How it works

Episerver CMS takes the list of the languages you can enable for a site from the languages that are installed on the host operating system. This may be a problem because the available languages can vary between different machines. If you have a language enabled in your Episerver CMS database which is not installed on your target machine, then an error occurs on start-up, which disables the entire site.

To add a new language, you need to install it on your operating system through the CultureAndRegionInfoBuilder class in System.Globalization. This lets you create a new language from scratch or by copying it from an existing language, (although you will have to run the code in the context of an Administrator account for it to work).

Adding a language to the list of available languages

The following code sample shows how to use CultureAndRegionInfoBuilder to create and register a new language based on an existing language, in this case creating Hong Kong English (en-HK) from UK English (en-GB). You need a reference to sysglobl.dll in your project for this to compile.

public static void CreateCulture()
{
    //* Get the base culture and region information
    CultureInfo cultureInfo = new CultureInfo("en-GB");
    RegionInfo regionInfo = new RegionInfo(cultureInfo.Name);

    //* Create the a locale for en-HK
    CultureAndRegionInfoBuilder cultureAndRegionInfoBuilder = new CultureAndRegionInfoBuilder("en-HK", CultureAndRegionModifiers.None);

    //* Load the base culture and region information
    cultureAndRegionInfoBuilder.LoadDataFromCultureInfo(cultureInfo);
    cultureAndRegionInfoBuilder.LoadDataFromRegionInfo(regionInfo);

    //* Set the culture name
    cultureAndRegionInfoBuilder.CultureEnglishName = "English (Hong Kong)";
    cultureAndRegionInfoBuilder.CultureNativeName = "English (Hong Kong)";

    //* Register with your operating system
    cultureAndRegionInfoBuilder.Register();

}

1. Run the code.
2. Start Episerver CMS.
3. Go to the admin view.
4. Select Config tab > Manage Website Languages.
5. Click Add Language. Your new local combination is ready to use.

Last updated: Mar 27, 2019