Skip to end of metadata
Go to start of metadata

With text replacement at the program level, you can create and manage up to three custom program types by replacing UI text in mentoring programs.

SAP SuccessFactors also provides a standard feature for text replacement at the system level. It is used when you have only one type of program and want to replace the text in all mentoring programs. The program-level text replacement, on the other hand, gives you the freedom to manage up to three custom program types in addition to the default mentoring program.

For example, you want to keep the default mentoring programs and create other types of programs (such as coaching programs or learning circles). With the program-level text replacement, you can define a text replacement pack for each custom program type and decide which replacement pack to use when you create a new program.

Provisioning Settings for Program-Level Text Replacement

Note: Your implementation partners can complete the configuration required in Provisioning to create custom locale for relevant system languages.

Caution: If you uploaded a replacement file for customizing program types prior to the Q1 2019 release, you now need to upload the file with an updated replacement text key (for example, TEXTREPLACEHEADING_TYPEA), ensuring that the text replacement works properly.


  1. In Provisioning, go to Company Settings.
  2. Enable Language Packs and navigate back to the Provisioning home.
  3. Go to Manage Languages.
  4. Add a custom locale for the default active language of your system, for example, en-US.
  5. For the custom locale, upload a custom text pack that specifies the detailed replacement text. For more information about how to define the content of the custom text pack, see Configuring Custom Text Packs for Custom Program Types.
  6. Repeat Step 4 and 5 for all active system languages. The text replacement only works in languages that have a defined custom text pack.

Configuring Custom Text Packs and Manage Languages for Custom Program Types

Note: Your implementation partners can work with you to define detailed replacement text in text packs (.csv files) for the custom locales.

You define the replacement text based on standard system messages and labels. For each language of the system, you have one custom text pack, and in each text pack, you can define up to three replacement options that correspond to the three custom program types.

In the procedure below, we take English US as an example. Please note that the definition of the replacement text is also required for other active system languages. The text replacement only works for the language with a defined and uploaded custom text pack.

Therefore, if you want the text replacement to be working in other system languages, repeat the same procedure for those languages. Note that the replacement text must be defined in those languages.

  1. In Admin Center > Company Setting > Manage Languages.
  2. Download the default labels of English US  > Actions column "Download Default Labels"

  3. A .csv file that contains all system labels opens.
  4. Save the file to your local drive and open the file with MS Excel to edit the labels and messages.
  5. Identify mentoring-related labels and messages in the sheet.
    1. You can sort them by key. Keys of mentoring-related labels and messages start with either of the following:
      • DEVELOPMENT_GO_DRTMMentoring
      • DEVELOPMENT_GO_MentoringProgram
  6. Keep the mentoring-related labels and messages in the sheet and delete all others.
  7. Delete the column C.
  8. Save and close the sheet.
  9. Open the .csv file again, but this time with Notepad, Open Office, or any UTF-8 editor to define replacement text.

Each line of definition must contain a key and the detailed replacement text, the two elements separated by a comma. Instructions on how to define keys and the replacement text are as follows:


Enter a unique identifying key for the replacement text definition. The key consists of two parts, message key and replacement text key. The complete key must be formulated as: <message key>_<replacement text key>.

The message can by anything that makes sense to you. The replacement text keys, however, must be one of the following:
      • TYPEA

      • TYPEB

      • TYPEC

Each represents a replacement option. For example, you can use TYPEA in all replacement definitions for coaching programs and TYPEB for learning circles.

These three replacement text keys are also listed on the program-level text replacement configuration page, where you can further define a meaningful name for each key. You can access the configuration page through Admin Center  Manage Mentoring Programs  Settings  Text Replacement Configuration.


Enter your replacement text.


10. Replace all mentions of mentoring programs, mentors, mentees, and activities, with the keys of the relevant replacement text definition.


Before: Your $(employees) have applied to be mentors for the following mentoring programs.

After: Your $(employees) have applied to be $(DEVELOPMENT_MENTORING_PROGRAM_mentors_TEXTREPLACEHEADING_TYPEA) for the following $(DEVELOPMENT_mentoring_programs_TEXTREPLACEHEADING_TYPEA).

  1. 9. Add custom locale to the language you're working

  2. 10. Save your changes and upload the .csv file to the custom locale as its custom labels.

  3. 11. You should get a notification that upload has been successful.

Enabling Custom Text Packs in Admin Center

  1. Go to the configuration page for program-level text replacement: Admin Center > Manage Mentoring Programs Settings > Text Replacement Configuration.
  2. Enable the feature by selecting the Enable Text Replacement at Mentoring Program Level checkbox.
  3. Enable the individual replacement options and enter meaningful names (for example, Coaching Program) for the replacement options. The name will be listed in the dropdown of the Mentoring Program Text Replacement Option field on the program details page. When you create new programs, you can select a replacement option from the dropdown list.
  • No labels