SAP Knowledge Base Article - Public

2080201 - How can the order of fields be rearranged? - Employee Central


  • How can the order of custom fields be rearranged in Employee Central?
  • This article explains how the order of fields can be arranged in an instance.
  • What rules are associated with changing the order in which EC fields are shown in the user interface?
  • Changing field order via the Succession Data Model, the Corporate Data Model, and the Country Specific Data Model.

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
  • Employee Central


  • To influence the order in which EC fields are shown in the UI there are some options and rules to be aware of.

Succession and Corporate Data Models:

  • The order, in which fields in these xml fields are displayed in the UI, are determined by the order they are listed in the Corporate or Succession Data Model xml file.
  • Assign the attributes in the expected order in the xml itself.

The exception to this is the start date:

  • This always appears on top of the screen as the date when the change is supposed to be effective. 

Country Specific Succession Data Model:

  • The CSF Data Model only contains the CSF fields. All the standard fields are defined in the Succession Data Model. CSF fields are shown in the order they are configured in the CSF Data Model, but after the SDM standard/global fields. The only exception here is the address field. The field order in which the data in the xml itself for country-specific elements is only relevant for the HRIS element homeAddress.
  • In the UI the CSF fields are only shown after all the fields in the Succession Data Model - UNLESS you choose to use the following specific xml tag in the CSF.
  • To have the CSF field showing up between global fields, this can only be done in relation to the Succession Data Model fields. With the tag <display-order-follows> in the XML file of the country-specific Succession Data Model (CSF DM), it can be defined that a certain field follows some other SDM field on the UI.

<display-order-follows ref-id="SUCCESSION-DATAMODEL-FIELD-TO-FOLLOW"/>


  • Here is an example from the country-specific Succession Data Model where the custom field being used is displayed after the field for the employee class for the country USA:

<hris-element id="jobInfo">
<hris-field max-length="256" id="custom-string3" visibility="both" type="worker">
<label>USA Dept Head</label>
<display-order-follows ref-id="employee-class"/>

  • This display-order-follows tag is to be used only in the CSF succession data model. This is not available in the Country Specific Corporate Data Model or elsewhere.  
  • This will only work On View and not in Edit mode.


SF, Success Factors, Succession, Corporate, Country Specific Data Model, Field Order, Employee Central, display-order-follows ref-id , KBA , LOD-SF-EC-BCI , Manage Business Configuration (BCUI) & Data Models (XML) , LOD-SF-EC-PP3 , People Profile (PP3) , How To


SAP SuccessFactors Employee Central all versions ; SAP SuccessFactors HCM suite all versions