SAP Knowledge Base Article - Public

2457516 - Cannot update/ modify username


  • I am trying to update the username value for a user, when I try to apply the change, the username does not update.
  • When I try to update a username via employee export and import the change does not apply.
  • When I try to update a username via employee profile, the username does not change, it remains the same.

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


  • BizX Platform
  • Employee Central
  • Employee Profile



The username field, is stored in the basic user field/employee export file.

The username field is the field that a user's uses to sign in and is generally mapped from the Person ID for EC customers on initial hire.
It can be different from the User ID and Person ID but for simplicity it is often the same value.

If a concurrent employment or global assignment is added to the employee, or the employee is rehired to a new employment then the system automatically assigns another user name and user ID to the employee.
The username can be changed via import or in the UI.

You can configure this field to be visible in the UI, by setting the field to visible.

This can and should be used for single sign-on (SSO). Please View: 2493579 - Employee Central: Person/User IDs Used Within Employee Central - SuccessFactors Employee Profile

Employee Central:

  • Username is not handled as standard in Employee Central, therefore Username should be maintained via Admin Center > Import Employee Data > Basic User Data import (UDF import), but some customer configurations do capture a Username value in EC and synchronize it to EP. Please view 2089382 - User Import Error - Duplicate Username - Platform
  • You can check this by exporting the Succession Data Model, scrolling to the bottom section “sync-mappings” and see if any of the mappings point to the standard-element “username”. If they do, then the username should be maintained in the relevant EC portlet instead.
  • Please note this is not a recommend HRIS Sync Mapping
  • If you are updating the username in an EC portlet and are unable to do so, this will be caused by the username already being in use or used for a soft purged employee, please see the following KBA for further detail - 2328243 - HRIS Sync: Configuring a sync-mapping from an EC field to username (EP)
  • If a customer does not have a HRIS Sync Mapping, EC is not involved in this process at all.

Employee Profile:

  • If you maintain the Username field on an Employee Profile portlet and are unable to change the value via the UI please try to Update the value via an Import. Please see the below Import section for more detail.
  • If you are able to update the value via the import but not the UI, please reach out to the Employee Profile support team (LOD-SF-EP). 


  • If  a non-EC enabled instance, imports to update the username must be carried out via:
    Employee Export > Export UDF > Employee Import > Import UDF. 
  • If a EC enabled instance, imports to update the username must be carried out via:  
    Employee Data Import > Import Employee Data with 'Basic User Data' option
  • When you try to import the updated file, if you see the following error message "Failed to add/update user [*****] "test user" (N/A;N/A;N/A): General Error with error code - -27" it means that there is a purged record for this username in our database.
    This purged record will need to be permanently deleted via the user permanent purge first before you can modify the username of your existing user. See KBA 2392076
  • If you are still unable to update the username via import please reach out to the Platform Support Team (LOD-SF-PLT) as they provide support on the import process for both EC and non-EC enabled instances.

FAQ - Additional Information

Q) Han Can duplicate or unwanted users be removed from the system??

A) See below

  • 2545988 - How to Purge/Delete users in SuccessFactors Cloud
  • 2615360 - Data Protection and Privacy - Data Retention Time Management (DRTM) - Master Data Purge for Inactive Users

See Also

  • 2495643 - SuccessFactors User IDs - Clarifying the Different IDs
  • 2089382 - User Import Error - Duplicate Username - Platform
  • 2730512 - Changing Username - Error Username already exists, please choose another one - Platform BizX  
  • 2088065 - Data Retention Management - Purge Data - Platform
  • 2089382 - User Import Error - Duplicate Username - Platform
  • 2392076 - User Permanent Purge Feature
  • 2615360 - Data Protection and Privacy - Data Retention Time Management (DRTM) - Master Data Purge for Inactive Users


username, - 27, 27, update username, can't update username, modify username, Failed to add/update, basic import, username , KBA , LOD-SF-PLT , Platform Foundational Capabilities , LOD-SF-EC , Employee Central , LOD-SF-EP , Employee Profile , Problem


SAP SuccessFactors HXM Core all versions