SAP Knowledge Base Article - Public

2576546 - Working with Manage Language Feature - Platform


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 HCM Suite


You can use the Manage Languages tool from within the Admin Center to overwrite UI label values in any language (US English or any language that SAP SuccessFactors currently supports see KBA List of Supported Languages with Locales (BizX) 2269945  This is useful for the following situations:

  • 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.


  1. Enable “Language Packs” option from Provisioning should be enabled on customers instance. 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 enabled in RBP Roles granted to an admin user. Go to 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):

Step 2.PNG

  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.

Step 3.PNG

  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, select the checkbox next to the language (English US), scroll to the bottom of the page, and on the For Checked Items Above dropdown menu, select Download:

Step 4.PNG

  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:

Step 6.PNG

  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):

Step 7.PNG

  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
      Notes: Currently, when exporting a langugae 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 > Select Created Custom Language > Choose File > Select created file > Import:

Step 9.PNG

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

Step 10.PNG

  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:

Step 11.PNG


1802 Release Changes to Layout

Previously, the import language pack was a separate field on the top of the Manage Language page. It is now incorporated into the main table. The activation and deactivation of the language is now possible using a checkbox and select save at the bottom of the page:


In addition, the Action column was enhanced to allow the addition and removal of custom languages, as well as downloading the custom labels:


See Also

SAP Help Portal: Working with Manage Languages

List of Supported Languages with Locales (BizX) 2269945

Text Replacement: How to change words using replacement text 2089472


3 tier language pack, Text Replacement, Manage Languages, Label, Update, Text, Tier 2, Changes,  Language Pack, Custom Label, Custom Labels, Custom , KBA , LOD-SF-PLT-LAN , Translations & Text Replacements , LOD-SF-PLT , Platform Foundational Capabilities , How To


SAP SuccessFactors HCM Suite all versions