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

Multiple languages and translations

Describes an overview of using multiple languages and translations in Optimizely Configured Commerce.

Optimizely Configured Commerce integrates Multi-Language and Translation capabilities directly into its Content Management System (CMS). These tools empower site administrators to define the website display language for users, and create unique content by language code, device type, and user persona. This functionality supports all Unicode languages, with the exception of languages that have right to left presentation (such as Hebrew and Arabic).



Database collation is only important for non-unicode datatypes (char, varchar). As Configured Commerce supports Unicode, database collation is not a concern.

Website implications

Website users may view the site in any languages marked as Live under the website's Languages tab. When an anonymous user browses the site, the site automatically is displayed in that user's browser's default language code, if available. If that language is not available on the site, the website's default language is displayed.

When a user is logged in, the user sees the language compatible with the language code defined in their Admin Console user record.

Users may change the displayed language via the Language Selector menu on the website's header.

If the user chooses a language via the Language Selector menu, this selection is saved in the browser's cookie. Each time the user views the site with that browser, the language defined within the cookie is displayed.

If no translation is available within the selected language for a section of text, text from the website's default language is displayed. This same hierarchy exists for content properties related to Persona and Device Type.


Configured Commerce has two options for managing translations: Field Translations and the Translation Dictionary. Field translations are for individual fields found on commerce objects, such as Products, Promotions, or Categories. An example would be providing a translation for the Product Title of a particular Product. The Translation Dictionary manages translations for things such as messages, attributes, attribute values, units of measure, and labels. For example, providing a translation for the unit of measure of Each.

Generally stated, field translations are more granular in nature and are orientated toward individual records, whereas the Translation Dictionary is more global in nature and provides translations for text that is shared across the website.