HomeDev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunitySubmit a ticketLog In
GitHubNuGetDev CommunitySubmit a ticket

Add languages

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 Optimizely Content Management System (CMS) installation.

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 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).

Add 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.



Custom cultures such as ”sv-gb” and "en-fr" are not supported for solutions running in Optimizely Digital Experience Platform (DXP). See Optimizely DXP - Multisite Development.

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
        //* Set the culture name
        cultureAndRegionInfoBuilder.CultureEnglishName = "English (Hong Kong)";
        cultureAndRegionInfoBuilder.CultureNativeName = "English (Hong Kong)";
        //* Register with your operating system
  1. Run the code.
  2. Start Optimizely 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.