HomeDev GuideRecipesAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunityOptimizely AcademySubmit a ticketLog In
Dev Guide

Select languages

Information on the Languages tab in the Optimizely CMS (SaaS) Settings.

🚧

Important

An administrator (and developers with administration access rights) enables content languages.

To set the CMS (SaaS) user interface language, see Set a personal language preference in Get started with CMS (SaaS).

Editors can create content in a language after you activate it and set an access level for a language to authorize editors to create or edit pages in that language.

When an editor copies a page, language versions are copied regardless of the editor's language rights. This means that if an editor with access rights to English only copies a page that exists in English and French and pastes that somewhere, both language versions are copied.

Go to Settings > Languages. The installed website languages display.

  • Sort by clicking any of the column headings.
  • See which languages are set as available (blue text) and unavailable (grayed-out text).
  • Adjust the order of the languages by changing the sort index number in the language settings.

Add a language

  1. Go to Settings > Languages and click Add Languages.

  2. Select the languages you want to add. You can search to filter languages.

  3. Click Add Languages to add them to the languages list.

  4. Click the language you just added to edit its settings.

  5. Complete the following language settings, and then click Save.

    • Name –  Enter a name for that language that displays in the edit view. The field contains the name of the language encoding, but you can change this if you want.

    • Template icon – Enter the relative path to an icon symbolizing the language.

    • URL slug – Provide a specific prefix to show the content of the relevant language. If you do not provide a prefix, the language code is used, such as www.company.com/nl.

    • Sort Index – Enter a number to indicate what precedent this language has.

    • Fallback Language – Select the language you want to serve when a visitor requests a page in a language that has no content. Fallback languages are recursive, meaning if the requested language has no content, CMS (SaaS) checks its fallback, then that language's fallback, and so on until it finds available content. For example, if French Belgian (fr-BE) falls back to Dutch Belgian (nl-BE), and Dutch Belgian falls back to Dutch (nl), CMS (SaaS) serves content in the first language in the chain that has content for the requested page.

      CMS (SaaS) prevents circular fallback languages. If language A falls back to language B, you cannot set language B to fall back to language A.

      After you set a fallback language, click Apply Changes back on the main Languages page for Graph to re-index and apply the fallback language.

    • Available – Select if you want to make the language active for editing in edit view. This option also determines whether the language is available to website visitors. A disabled language is not visible in the edit view. Existing content in that language is still accessible but cannot be edited.

  6. Go to Permissions to define which editor groups have access to create and edit content in this language.

    When you add a language, it is available to the Everyone group by default, which means item-level access rights apply across all languages. An editor must have edit access for both a specific item and a specific language to edit content in that language. An editor with delete rights on a node can delete the entire node and all its language versions, including languages the editor does not have explicit access to.

    If you remove the Everyone group from a language to restrict it to specific users or groups, any editor not explicitly added to that language loses the ability to create and edit content in it.

  7. Click Save.

Search results in different languages

CMS (SaaS) works with Optimizely Graph to deliver search results for up to 33 supported language locales. See Supported locales with language analysis.

📘

Note

Editors can create content in any of the 790 possible languages in CMS Settings by making those languages Available in their instance. Many languages are regional variations of a single language. For example, English exists in more than 100 variants.

Consider a search for the word "world" on a page that is translated into Swedish, English, and Akan. Optimizely Graph can search all three translated pages and find "world" in all three translations.

However, Optimizely Graph does not have a language analyzer for Akan, so it cannot find the plural of the search term (worlds). It can find worlds in the Swedish and English translated pages because those languages have analyzers.

Remove an existing language

Remove a language from the website by opening the language settings and clearing the Available checkbox.