Enable multiple-language website support

Business isn't confined to a single region or a language. A single website can display content in multiple languages to reach customers around the world. The content of your website can be translated into multiple languages while maintaining a single content hierarchy.

To enable multiple languages for a website, follow these steps:

1. Enable languages in a Microsoft Dataverse environment.

   Note

   Make sure that the process to enable a language on Dataverse completes before continuing to the next step. It may take an hour or more to provision the languages.

2. In the Portals Management app

3. Go to Website > Websites.

4. Select the website to add language support to.

5. In the Supported Languages section under the General tab, select New Website Language.

6. Fill in the form, including Portal Language (a lookup of languages that are activated in the organization and are supported by portals) and Publishing State.

   

   

You can set the default language of your website by changing the Default Language lookup to one of the enabled website languages.

Supported languages

The following table shows all the languages currently available out of the box. This list can be found by going to the Portals Management app, in the Content section and then select Portal Languages. The display name of a language can be changed after selecting the language to change from this page.

Add custom language

This section explains how to enable support for additional languages beyond those provided by Dataverse, allowing you to customize your website's language options.

If you want to add custom languages, follow these steps:

1. Go to Power Pages home and select the environment where the site is located.

2. Select the site and select Edit to open the studio.

3. Select More Items (…) to open the Portal Management App.

4. In the Supported Languages sub grid, select New Website Language.

5. Select the search icon in the Portal Language lookup.
   

6. Select New.

7. Select the Discard changes button.

8. Enter the details for the new language.

   Note

   • Enter the Dataverse LCID in the Dynamics 365 language field, and the Power Pages LCID in the LCID field.
   • Dynamics 365 language must be one of the 43 languages supported by Pages, such as 1033 for English.

   

9. Select Save & Close.

10. Select the recently created language in the Portal Language field.

11. Set the Publishing State to Published.

12. Select Save & Close.

Create content in multiple languages

This section explains how to add localized content to your website, enabling it to display information in multiple languages for a global audience.

Add an existing and supported language

1. Open the Portal Management app.

2. Go to Website > Content > Web Pages to see a list of content. For each webpage, there will be a parent version of the page and a child version of the page for each language activated for the website.

3. To add a new localization of the page, go to a base page and scroll down to Localized Content.

4. Select + New Web Page on to create a lookup for the localized version.

   

Knowledge articles will only be displayed if they've been translated into the language the user sets the website to be displayed in. However, forums and blogs allow for more control over how they're presented in other languages. Specifying a language for a forum or blog is optional. If a language isn't specified, the forum or blog will be displayed in the primary language of the organization. If you want the forum or blog specific to a language, you must create it and assign the language to it.

Web link sets are the navigation links at the top of the portal. In the Portal Management app, go to Content > Web Link Sets to update the translated text of the menu items. When a language is active for the website, a new set of links is created for the newly activated language.

Create content snippet for custom language

To create a content snippet, you first add a site setting. Follow these steps to add the site setting:

1. Select the Site Settings tab.
2. Add Site/EnableContentSnippetTranslationForForms and set its value to true.
3. Select Save and Close.

To add a content snippet, set the translation. For example, update the Title, Regarding, Source, and Comments label translations to Welsh.

1. Select Content Snippet from the Related drop down.
2. Select New Content Snippet.
3. Provide the name, such as Feedback Form. This name is used later.
4. Enter the value in JSON format for each label. For example: { "Title":"Teitl", "Regarding":"ynghylch", "Source":"ffynhonnell", "Comments":"sylw" }
5. Select Save & Close.
6. Select the Basic Forms tab. You can follow the same steps for multi-step forms and lists.
7. Select the form with the labels you want to translate.
8. After the selected form opens, select the Basic Form Metadata tab.
9. Select New Basic Form Metadata.
10. Select Type as Attribute.
11. Select the field where the label needs to be translated.
12. Enter the value in the label for English (United States) in this format: [[ContentSnippet.{<content-snippet-name>}.<fieldName>]]. For example,[[ContentSnippet.{Feedback Form}.Title]]
13. Select Save & Close.
14. Repeat the same steps for other fields.
15. Clear the cache, and launch the site.

View website in a different language

Once the languages have been enabled, by default, users will see a drop-down on the web pages, which will allow them to switch the currently viewed content to different enabled website languages.

Configure user's default language

To avoid choosing the language from the drop-down each time, website users can set the default language by entering it in the Preferred Language field within the user profile section.