Set Up Multilingual Community Portal

Introduction

Before you can translate your Community Portal, you'll need to prepare some settings ahead of time in your Salesforce org for your Community Portal. These settings enable the tools you'll use to translate and confirm the language(s) you will make available for translation in your Community.

Table of Contents

Verify Salesforce Language Settings

Default languages need to be set in both your Salesforce organization and the Community Site Builder prior to translating your Community Portal. Let's take a look at where these settings are and how to configure them.

Salesforce Org 

Your Salesforce org’s default language will automatically fill in any areas in your Community where a translation is not already provided. Administrators can set a default language for your entire Salesforce organization under Company Information in Setup. They can also define languages available for staff users to choose from in the org using Language Settings, also located in Setup.

Salesforce Org Default Language

You'll access your org's default language from the Company Information page.

Navigate to Setup and [Enter] Company Information in the Quick Find Search Bar. Company Information will generate under Company Settings in the side bar. 

Click Company Information to open the Company Information page.

The Company Information page displays your organization's profile information. Your org's default language is located in the Default Language field.

Click edit to edit the fields on the Company Information page.

Define Available Languages in Language Settings

You'll define languages available for staff users to apply when using your org from the Language Settings page.

Navigate to Setup and enter Language Settings in the Quick Find Search Bar. Language Settings will generate under Company Settings in the sidebar. 

Click Language Settings to open the Language Settings page.

Available languages will list in the Available Languages list. Languages currently being displayed or currently in use by your staff users will list in the Displayed Languages list. 

To add languages to the Displayed Languages list, [Select] your desired languages from the Available Languages list. [Click] the Add button to add the languages to the Displayed Languages list.

To remove languages from the Displayed Languages list, [Select] the desired languages from the Displayed Languages list. [Click] the Remove button to add the languages to the Available Languages list.

Click Save to apply your changes.

Enable Translation Workbench

The Translation Workbench from Salesforce allows you to perform the following:

• Specify languages to translate

• Assign translators

• Create translations for customizations

• Override labels and translations from managed packages

• Translate field labels and picklist values

The Translation Workbench will need to be enabled for you to fully translate your Community Portal. You can find directions on enabling the Translation Workbench through Salesforce here. It will be enabled by default for the System Administrator profile, but it will need to be enabled manually for any users who will create translations for your community.

Add Translated Languages and Assign Translators: You'll need to activate the language(s) you'll be translating in your Community in the Translation Workbench and assign staff users in your org as translators to those languages.

Activating a language makes translations entered in the Translation Workbench available to your users.

Designating a staff user as a translator means they will have the permissions necessary to create and apply translations in the workbench. These should be people fluent in the language you are adding to your Community.

Check out Salesforce's directions here on activating languages and adding translators.

Access Translation Workbench

1. From Setup, enter Translate in the Quick Find Search Bar.
   

   

2. Select Translate under Translation Workbench from the results generated in the sidebar. The Translation Workbench page will open.
   

   

Verify Language Custom Label

You need to verify your Language Custom Labels are in place in order for translations to work successfully in your Community Portal.

1. From Setup, type Custom Labels in the Quick Find Search Bar. Select Custom Labels from the results. Custom Labels will open.
   

   

2. From the Custom Labels table, locate and select Language. The Language Custom Label page will open.

3. Locate the Local Translation section and verify the languages you previously activated in the Translation Workbench are listed. If they are not, proceed to the next step.

4. Click New Local Translations/Overrides. The New Translation page will open.
   

   

5. Under Translation Information, select your language from the Language picklist.
   

   

6. Type your language’s language code in the Translation Text field.

   1. The language code must be correct or translations for the language will not work in your Community Portal. Salesforce’s supported language codes are listed here.

   2. When using a dialect code, make sure to use an underscore, not a dash. (Example: en_US).

7. Click Save. Repeat steps 4-7 for all the languages you activated previously.

Enable Languages On Your Community Portal

You'll set a default language and all additional languages for your Community Portal from the Community Builder.

Additional languages will not appear in the Community as options for translation unless they have been enabled in the Builder.

1. To access the Community Builder, enter Digital Experiences in the Quick Find search bar. Results generate below.

   

2. Select All Sites from the results generated. The All Sites page opens.

3. Select the Builder link for your Community Portal. The Community Builder will open in a new tab in your browser.
   

   

4. Click the gear icon to open Settings for the Builder.

   

5. From the Settings window, select Languages to open the Languages Settings.
   

   

6. The default language is located in the Default Community Language field. The language selected here is the default language for your Community Portal.
   

   

7. You will need to add all languages you plan to enable on your Community Portal using the + Add Languages button.

8. Select + Add Languages below the Default Community Languages field. The Add Languages modal will open.
   

   

9. Select a language to add from the Available Languages box and click the > arrow. The selected language will transfer to the Community Languages box. Repeat this step for all languages you want to add to your Community.
   

   

10. Click Save to save your changes. Your selected languages will now display in a new section Community Languages, beneath the + Add Languages button.

11. You can click through your Community Languages to view and edit their details, such as the Display Label. Make sure the Active on Live Community field is checked when you are ready for the language to be available in your Community.
    

    

12. Click Publish to apply your changes. You'll receive an email confirmation when your changes are live in your Community.
    

    

Enable Fonteva Community Languages

After defining Language Settings in your Salesforce org and in the Community Builder, you'll enable languages through Fonteva to your Community Portal using the Fonteva Community Languages tool.

1. Go to App Picker > Spark Admin > Tools > Fonteva Community Languages.

   

2. The default language set in Company Information will display as the default language under Community Languages.

   

3. You will need to enable the languages you added in the Community Builder. Click Manage Languages. The Manage Languages window will open.

4. Select the languages you want to enable from the Available Languages list and click the > button. The selected languages will get added to the Community Languages list.

   

5. Click Save to apply your changes.
   

Like in the Builder, you can click through your Community Languages to view their details. You can edit the Display Name if desired. Make sure the Active in Community field is checked when you are ready for the language to be available in your Community. 

Generate Translation Records:

To begin translating record data in your Community Portal, you’ll first need to generate translation records through Fonteva Community Languages available in Fonteva Framework. Translation records enable translatable fields on objects. You will create your translations in these fields using Record Translation Tables accessible via the Translate action.

Click the Generate Translations button in the top right corner. The Select Languages to Generate Translation Records modal will open.

Select the language or languages you want to generate translations for under the first column and click the > button to move the languages to the second column. Select Select All to move all the languages over at once.

Click Continue. The modal will open on the Select Objects to Generate Translation Records view.

All the available objects that have translatable strings list in the Available Objects list. Select the Objects you want to generate translation records for and click the > button to move them to the Selected Objects list. Optionally, you can search for particular Objects using the Object Search field at the head of the window.

When all of your desired Objects have been moved to the Selected Objects list, click Generate to generate translation records.

Translation records will show up under the Translations object and become available for translation through applicable record pages and inline translation through the Events Builder. You may want to select the All list view or create your own list view.

You can generate translation records for the following objects:

Create Translation Records

If there is a field you would like to generate translation records for that is not included already, you an add it through Custom Metadata Types.

Navigate to Setup and type Custom Metadata Types in the Quick Find search bar. Click Custom Metadata Types from the results generated to open the Custom Metadata Types page.

Locate the Bulk Generated Translation Fields metadata type and click Manage Records. This metadata type consists of all fields with strings generated from the Fonteva Community Languages Tool.

Click New. The Bulk Generated Translation Fields Edit page will open.

It’s best to open the Object Manager to the field you want to add, as there is API information you will need to complete these next steps. For this example, we’ll be adding the Group Instructions field from the Package Item object.

Locate the content for the following fields on the field’s page in Object Manager using the below images:

• The field’s field Label and API Name are found under the object’s Fields & Relationships:
  

  

• The object API Name is located on the field’s object Details page in Object Manager:
  

  

On the Bulk Generated Translation Fields Edit page, apply the contents of the Field Label field from the Object Manager to the Label field. The Bulk Generated Translation Field Name field will automatically generate content based on your entry in Label.

Apply the API Name for your field in the Field field.

Apply the API Name for your field’s object in the Object field.

Click Save.

You will need to then generate the translation records for your newly added field in the Fonteva Community Languages tool. Follow the directions for generating translation records above and ensure you select the object your field belongs to when selecting objects to generate translation records.

Check Translation Master Switch

1. Go to Setup.

   

    

2. Enter and select Custom Metadata Types in the Quick Find box.

   

    

    

3. Next to Fonteva Registry Entry, select Manage Records.

   

    

4. Select Is Enabled.

5. Mark Entry Value as true.