2444264 - How to display employee's preferred name in Quick Card and People Search

SAP Knowledge Base Articles - public

2444264 - How to display employee's preferred name in Quick Card and People Search


  • When searching an employee, is it possible to have employee's preferred name displayed in the result list of People Search and Quick Card?


  • SAP SuccessFactors HCM Cloud
  • Employee Central

Reproducing the Issue

  1. Go to People Search
  2. Search employee by "Preferred Name"
  3. Employee's name format shows as [FIRSTNAME] [LASTNAME]


  • An employee is known by his/her preferred name within his/her company.
  • When others try to search this employee, they do find this employee by using preferred name. However, the preferred name of this employee is not listed in People Search or Quick Card. 


  • Steps to setup this functionality:
    1. Setup "Name Format" Functionality
      1. Opt-in "Enable Name Format" under "Company Settings" in Provisioning (Note: As a customer you may not have access to this and you would have to contact support or your implementation partner to set this backend setting).
          1. 1.png
      2. Create a Name Format
        1. Admin Center -> Manage Data
        2. Create New -> Name Format
        3. Fill in required fields as below and click on save
          1. 2.png
    2. Associate Name Format with Legal Entity
      1. Admin Center -> Configure Object Definitions
      2. Select Object Definition, and in the adjacent field, select "Legal Entity"(Or any LegalEntity to which the Name Format should be assigned)
      3. On the right hand side of the screen, on the Take Action menu, select "Make Correction"
      4. Create a new association with the details highlighted in the screenshot below, then select Save
          1. 3.png
          2. 4.png
      5. Assign the Name Format to Legal Entity
          1. 9.png
    3. Setup "Formal Name" field
      1. Enable "Formal name" field
        1. Admin Center -> Manage Business Configuration
        2. Employee Central -> personalInfo
        3. Choose "Yes" in the dropdown list of "Enabled" field
          1. 5.png
        4. Click on Save
      2. Setup RBP for "Formal Name" field
        1. Admin Center -> Manage Permission Roles
        2. Click on the Permission Role which the permission would be assigned
        3. Click on "Permission" under "Permission Details"
        4. Choose "Employee Central Effective Dated Entities"
        5. Grant "View Current", "View History", "Edit/Insert", "Correct" accordingly of "Formal Name" field to the Permission Role
        6. Click on "Done" and "Save Changes"
      3. Check "Formal Name" field under "Personal Information" portlet
        1. The Formal Name field should appear under "Personal Information" portlet
          1. 6.png
        2. If the value is not correct with the selected Name Format, please perform the steps in KBA: 2295729 - Changing the Name Format Assigned to Legal Entity not Propagated to Employees
    4. After doing the steps above, you may now have employee's preferred name displayed in Quick Card and People Search:
          1. 7_meitu_1.jpg
    5. If you want to have the format as "First name (Preferred Name) Last Name", please add "()" to the preferred name field:
          1. 8.png


KBA , LOD-SF-EC-PER , Person Information , How To


SAP SuccessFactors HCM Core 1702