SAP Knowledge Base Article - Public

2576546 - Using the Manage Language Feature to Change Labels in SuccessFactors


  • Is that possible to change some specific label in SuccessFactors?
  • How do I customize labels in SuccessFactors?
  • I'd like to set custom names in some specific system labels;
  • Is there any feature through I can manage the labels in the system?
  • How can I change a label in a specific locale that is not available in Text Replacement functionality?

Image/data in this KBA is from SAP internal systems, sample data, or demo systems. Any resemblance to real data is purely coincidental.


SAP SuccessFactors HXM Suite


Use the Manage Languages tool from within the Admin Center to overwrite UI label values in any supported language (KBA 2269945).

This feature can be very useful in the following situations mostly:

  • You want to change default values of UI text (e.g., system text) to better reflect your particular business practices and culture
  • There is an issue with system text (e.g., grammar, syntax, key terms). Manage Languages allows for a quicker turnaround while waiting for the system text to be updated in a subsequent patch or release.

Note: Please engage Product Support if there is a default system label that is incorrectly translated for further support.

  • The Manage Languages page allows you to activate and deactivate locales, create locales that you can upload custom label values to, and download both custom and default label values.

Important Note: To-Do Tiles and Homepage sections related changes (KBA 2860570) have precedence over the Manage Language feature.


  1. Enable “Language Packs” option should be enabled for the instance in Provisioning;
    1. If you do not have access to Provisioning, you may reach out to your implementation partner/s and consultants or please contact support team for assistance.
  2. Still in provisioning make sure the option "Enable Manage Languages tool" is enabled.
  3. Text Replacement” permission should be granted to the user's Permission Group in RBP settings;
    1. Go through Admin Center > Manage Permission Role > Administrator Permissions > Manage System Properties > Text Replacement.


  1. Value replacement limit: You can overwrite up to 10,000 values per locale using Manage Languages. The default replacement limit is set to 100 values, which you can manually increase up to 10,000 using the Update option at the bottom of the page.
  2. Custom language pack CSV file size limit: The CSV file size limit is 10 MB. If you try uploading a file, which is anything more than 10MB, the system will time out and the file will not be uploaded.
  3. Text substitution syntax: You need the text substitution syntax to replace a word throughout the system. Otherwise, each string that includes the string will need to be replaced through Manage Languages.
  4. Changing labels does not update the language phrasing used within our Mobile Application at this time.


  1. Go to Admin Center > Tool SearchManage Languages.
    From here, you will see the list of all language packs enabled for your instance.


  1. Under the Action column, click Add corresponding to the language pack you've chosen (sample is English US) (If you have already added a custom locale, skip to step 4):


  1. It is required to enter a new name for the custom language pack (such as, English US Custom), and click OK. The custom language pack gets appended to the original language pack.


  1. Next, you need to download the CSV file of the original language pack that has all the default application UI labels, some of which you will customize. To download, click on the three dots for actions and select Download default labels.


  1. Open the downloaded CSV file in any text editor (Notepad or Notepad++). It should be similar to the screenshot provided below. This file, which is the original CSV file, contains the entire list of key values (key) and their corresponding UI labels. For this sample, en_US (English US):

Step 5.PNG

  1. From the entire list, you will need to select only those tokens which you wish to replace the text/label with. To know which tokens should be selected, you need to switch your Language to English Debug. If you do not have this language pack listed on your instance > Change Language, contact support for enablement:


  1. Go to the page where you would like to change the label. In this sample, we will be changing the label for Home Page from the Module Picker. Get the values inside the colon (sample in the screenshot is COMMON_HOME_TAB):


  1. You will need to create a new file where ONLY custom translations will be placed. To do this, you may open a new file in notepad/notepad ++ > Copy the header and remove the last value.
    NOTE: For every token, it should be 1 line on the file as shown below. First value should be the token > Comma > New Translation. Both enclosed in double quotation marks.


Step 8-1.PNG


Step 8-2.PNG

Note: All custom translations will be saved in a single file. Once done, save in .csv format.

How to insert link breaks in customized label keys?

\n and \\n characters mean insert a new line. For example, add the following values to the custom upload, and upload the file back to the instance. Then the new error message can be changed line automatically.

ERR_REQUIRED_FIELDS Error - You didn't fill all mandatory fields. \\nSection: {0}\\n {1}\\n

Note: When exporting a language pack, the following special characters will be lost "\n", "\r", "^". They will be replaced by a space. Customers will need to manually insert the new lines ("\\n") again when importing the language pack.

  1. Go back to Admin Center > Manage Languages > Expand the language > Click on Action three dots for the custom locale > Upload custom labels > Select created file > Import:


  1. You should be able to receive a successful pop-up showing up that the upload is successful. Click Ok:


  1. Once done, try to logout, log back in and see if the translation updated. You might need to change language depending on what locale you have created a custom translation with:


See Also


sf, bizx, success factors, PLT, platform, translation, label change, custom label, English debug, custom locale, translate, text replacement , KBA , manage language, language, label, manage , tier 3, change label , LOD-SF-PLT-LAN , Manage Language & Text Replacements , LOD-SF-PLT , Platform Foundational Capabilities , How To


SAP SuccessFactors HXM Suite all versions