Dev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunityDoc feedbackLog In
GitHubNuGetDev CommunityDoc feedback

To create a language, a user must be an Optimizely <<product-name>> administrator.

  1. From within the **Admin Console**, go to **Administration** \> **Localization** \> **Languages.**

  2. Select **Add New Language**.

  3. Fill in the following fields with the information relevant to the language being created:

    1. (Required) **Language Code** – The ISO 639-1 code for the country and the culture. For example, Spanish for Mexico would be "es-mx".

    2. (Required) **Description** – A short descriptive name of the language being created

    3. **Culture Code** – In this field (added in version 3.6), populate the language culture name. Typically, this field is left blank, as the scenario for its use is rare. An example, en-US is English in the United States and fr-MC is French in Monaco. A full list of these language culture names can be found at,, or for a small fee.

    4. **Image File Path** – URL for image file to represent language (commonly used for flag images). The maximum size for this image is 16x16 px

    5. **Alternate Languages** – Additional alternate language codes for specified language entered as a comma separated list.

      • If this field is needed and is not visible, it can be exposed using the Application Dictionary. Refer to this article for more information: Working with Properties in the Application Dictionary

    6. **Default System Language** – Sets language as the default for the application. This is used as the From language for machine translations using a translation service. English (EN) should be set as the Default System Language.

    7. **Has Device Specific Content** – Sets whether device-specific (Desktop, Tablet or Mobile) content can be created for the specified language.

  4. Click **Save and Add** to save the language record.