Knowledge Center

Knowledge Center > Zuora CPQ > Zuora CPQ > General Configurations of Zuora CPQ > Localize and Customize Labels and Messages

Localize and Customize Labels and Messages

This article describes how to translate or customize the user-facing text in Zuora CPQ.

Salesforce Translation Workbench and Zuora CPQ

In Zuora Quotes and Zuora 360 the master/default values are in English, and out-of-the-box products do not need any customization or translation for English users. However, starting with Zuora Quotes version 5.100 (July 2013), you have an option to use the Salesforce Translation Workbench to translate or customize the text that users see in Zuora CPQ. This includes labels for page titles, buttons, error messages, etc. and object text in displayable field names and help text.

To See the Translation

In Salesforce, if user's personal language setting specifies a language and the text has a value for that language, then the translated value is displayed. Otherwise, Salesforce displays a master/default value or an overridden value if you have provided one.

To see translations that you enter in Translation Workbench, specify the desired Language in your personal settings.

To change the personal language setting:

  1. Navigate to user name > Setup > Personal Setup > My Personal Information > Personal Information.
  2. Click Edit.
  3. In the Locale Settings section, change the Language setting.
  4. Click Save.

Enable Translation in Salesforce

To use the Translation Workbench, enable Translation Workbench in your Salesforce org.

To enable Translation Workbench:

  1. Navigate to user name > Setup > Administration Setup > Translation Workbench > Translation Settings.
  2. Click Enable.
    Enable_Translation.png
  3. Click Add to add English and any other language(s) that you will be using.
  4. For each language that you intend to customize or translate:
    1. Mark the language as Active.
    2. Specify one or more translators who have a permission to enter the translations.
      NewLanguage.png
  5. Click Save.

If you need additional details on configuring the Translation Workbench, refer to the Salesforce documentation.

Translate in the Salesforce UI

Translate and Customize Labels

Custom labels are used for page titles and other page text, some button labels, and error messages. For these items, Salesforce supports:

  • A default value
  • Optional translated values for multiple languages

To view and edit the existing custom labels used in Zuora CPQ:

  1. Navigate to user name > Setup > Create > Custom Labels. A list of custom labels appears. Since you may have multiple applications in your org, you may see custom labels that are not related to Zuora CPQ.
    Custom_Labels.png
  2. Clicking on a Name you want to translate.
  3. On the Custom Label page, click New Local Translations / Overrides.
  4. On the New Translation page, select the language in the Language field.
  5. In the Translation Text field, enter the translated text. 
    NewTranslation.png
  6. Click Save.
  7. On the Translation Detail page, you see the new translation text you just entered.
    Translated.png

Translate the RECORD_TYPE_MASTER Custom Label

For Zuora Quotes to work properly in the language settings other than English, you must translate a custom label, RECORD_TYPE_MASTER. The translated label must be exactly the same with the record type name that Salesforce provides in that language. The table below lists the translated label values in some of the supported language settings. Follow the steps described above to translate the label in your language setting.

Language Label Translation
Portuguese Mestre
Spanish Principal
English Master
German Master
French Principal
Italian Principale
Japanese マスタ
Swedish Huvud
Korean 마스터
Chinese (Traditional)  主要
Chinese (Simplified)  主类型
Dutch Hoofd
Danish Overordnet
Finnish Päätietue
Russian Основная
Thai หลัก

If the table above does not list your language setting, take the following steps to get the translated value in your language setting:

  1. Execute the following code in the development console to get the translated value: 
    System.debug('record types : ' + Contact.SObjectType.getDescribe().getRecordTypeInfosByName());
  2. From the log details, get the correct translation value.
  3. Follow the steps described above in this section to translate this label in your language setting.

Translate Object Field Labels and Help Text

Custom objects include field labels and help text that you may wish to localize or customize. For these items, Salesforce supports:

  • A master (default) value
  • An override value
  • Optional translated values for multiple languages

To translate object text:

  1. Navigate to user name > Setup > Administration Setup > Translation Workbench > Translate.
  2. In the Language field, select your org's language.
  3. In the Setup Component field, select  Button and Link Label, Layout Section, or Custom Field.
  4. In the Object field, select the object that has the labels you wish to translate.
  5. In the Aspect field, select Field Label or Help Text. This displays a list of the values that you can edit. Note that you can find information about the various Zuora CPQ custom objects at user name > Setup > Create > Objects.
  6. To edit a value, double-click on that field in the table and enter the text.
    Translate.png
  7. Click Save.

Translate Using Translation Workbench Export and Import

As an alternative to translating text in the Salesforce UI, you can export a file of translatable text, translate it offline, and import it back into Salesforce in the desired new language. You can edit the export/import file in a text editor. For more detailed information, refer to the Salesforce documentation about Translation Workbench.

Export

To export a file of text to be translated:

  1. Navigate to user name > Setup > Administration Setup > Translation Workbench > Export.
  2. Select Source to customize or one of the other options to translate.
  3. Click Export. This exports a file containing all the custom labels and custom object text, which you can then customize as desired.

Import

To import a file containing the translated label values:

  1. Navigate to user name > Setup > Administration Setup > Translation Workbench > Import.
  2. Click Choose File and select the file to import.
  3. Click Import.

Customize Using Translation Workbench Override

To override the master value of a text field:

  1. Navigate to user name > Setup > Administration Setup > Translation Workbench > Override.  
  2. In the Package field, select Zuora Quotes or Zuora 360.
  3. In the Language field, select English.
  4. In the Setup Component field, select Button and Link Label or Custom Field.
  5. In the Object field, select the object that has the labels you wish to override. 
  6. To edit a value, double-click on that field in the table and enter the text.
    Translate_Override1.png
     
  7. Click Save.

Limitations

The Salesforce labels and translation feature have the following limitations:

  • The maximum length for object field labels is 40 characters.
  • The maximum length for custom labels is 1000 characters.
  • The maximum of 5000 custom labels per org. This is the combined maximum for Zuora CPQ packages and any other packages you may have installed.
Last modified

Tags

This page has no custom tags.

Classifications

(not set)