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.

It is important you configure all of the settings mentioned on this page. You will not be able to successfully translate your community if these settings are not enabled.

You will need System Administrator privileges to apply the below settings. If you do not have these privileges, you'll need the assistance of someone in your organization with System Administrator privileges.

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.

Important

In the Language Preferences section, you will notice two checkboxes: Enable end-user languages and Enable platform-only languages.

Enable end-user languages enables languages that will get applied to your Salesforce org. Your staff users can select from these languages to translate your org. These languages are only intended for use by staff users in your org and are not counted as fully-supported languages from Salesforce. 

Enable platform-only languages enables language translation in your Salesforce org for apps and custom functionality on the Salesforce Platform where Salesforce does not provide default translations. You can translate items such as custom labels, custom objects, and field names. You can also rename most standard objects, labels, and fields. Informational text and non-field label text aren’t translatable. Platform-only languages should not be confused with the Fonteva Community Languages tool or the Record Translation Tables.


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.

Languages currently in use will be grayed out in the Displayed Languages list and cannot be removed.

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.

The Translation Workbench is not available for single-language orgs. Contact Salesforce to determine if you have a single or multi-language organization.

Please be aware: in a Developer organization with a managed package containing translations, the Translation Workbench cannot be disabled once it is enabled.

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.

You may want to complete translating with the Workbench before activating a language.

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.

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. 

You will not be able to edit the Active in Community field for the default language.

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:

Event

Item

Ticket

Store

Session

Custom Payment Type

Speaker

Form

Venue

Subscription Plan

Track

Badge Type

Section

Form Field Group

Sponsor Package

Price Rule

Community Portal

Catalogs

Community Menu Item

Package Items

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.