Skip to Content
Technical Articles

Key User Extensibility on SAP S/4HANA Cloud – Adding Custom Fields


Last reviewed for Updates: January 17 2019

Key User Extensibility on SAP S/4HANA Cloud – Adding Custom FieldsPart 3

Target Audience – Key Users

As a Key-User you would like to add new field to the existing Fiori Application in the cloud. For this demo, lets pick up the same app and add a new field to the UI

We need to add a new custom field, tie it to the standard Fiori UI app and publish it. For this we will go back the tile – Custom Fields and Logic as shown in the beginning of this blog

Let us pick a standard app – Create Internal Projects and add a new custom field to it. Please note that you can add fields only if the app is extension enabled. Click this link to know more about extensibility of this app

Click through this app. What we will do here as a Key User is – add a new section called ‘Project Sponsor Email’ and then add a new custom field called ‘Project Sponsor Email’. Let’s see how to achieve this

Let’s go back to the Tile Custom Fields and Custom Business Logic and click on it

Once you are in, you will notice two tabs – Custom Fields and Custom Logic. For this blog, we will work with first tab – Custom Fields. Under this tab, if some custom fields are already created you will notice them in the list and the Business Context to which they are related to

To start creation of new field, click on the icon. Once you click on this  icon, system will open a pop-up to provide new custom field properties

Select the Business Context, Label for your custom field, Identifier, Tool Tip and Type for the custom field

Now let’s understand what all these Field Properties mean to you as a Key User

Business Context – defines the business cases for which the new custom fields will be used. It primarily means that any new field which is created and assigned to a Business Context can be used for UI’s, Reports, Form Templates, Business Scenarios etc., are restricted to that Business Context only. Also, it is important to note that there is always a limited set of new custom fields

Label – is the field label that will appear on the UI

Identifier – Identifier identifies the newly created custom filed. In S/4HANA Cloud Extensibility every new field is identified by an identifier and it adopts a certain namespace provided by framework. For example – In the screen shot above –

YY1_: is for objects created in test system and that will be transported to production system. This namespace is only applicable for S/4HANA Cloud and not for On-Premise. The third part of the namespace for example _Cpr identifies the Business Context

Business Context Capacity – defines the storage capacity of the custom fields created by Key-User. As you can see in the screen shot above the new custom field will use 14% of the total storage provided by the standard

Once you click – Create and Edit, it is time to add more information about this custom field and enable its link

The first tab on this page is – General Information. Based on the type of field type chosen in the Field Properties, the details section will change. For example – Here for the field type – Email, the default length proposed by the system is 30. You can change the same

Move on to the tab – UI and Reports and enable the field usage of your custom field

Details about this tab –

Search Relevance – If you want to make the content of your field searchable then you may select this checkbox in Search Relevance column. This would make your field searchable in free-text searches

Details about other tabs

Email Templates – You can also add your field to the corresponding email templates, and thus make them visible in your personal email template

Form Templates – As a Key user can also enable the usage of the custom fields in the custom form templates or pre-delivered form templates (…which are extensible). Form Template is nothing but SAP Pre-delivered templates that are used for Output/Print Management. For example, output form for Invoice, Credit Memo etc. (This is not covered in this blog. More information here à Maintain Form Templates)

Business Scenarios – In a scenario where you as a Key User wants to enable the field for more than one business scenarios

Now click on blue Save button to save the changes

Now it’s time to Publish these changes so that this new custom field is now available in the field list for this App

Click on the blue Publish button and the system will start publishing the field. It will take a little time, before this field is published and is available to you as a Key User

Once Published it will turn into green

This paragraph here is for technical guys or developers to know, what happens in the background when a new custom field is created and it gets published. Key Users kindly ignore this paragraph and jump to next paragraph (Key User continue here) below

Adding a new custom field effects the underlying OData Service, Database tables etc.

Image Source: SAP TechED

At this point if you now click on Disable button under tab UI and Reports, you would notice that system would pop up a message displaying which all underlying objects will be effected due to this

Key Users continue from here

Let’s continue with the next steps. In this step, we will add this new custom field to the standard Fiori App

Let’s go back to the app and open the App in the Adaption Mode

Click on the user icon

Next click on the icon – Adapt UI

This would open the app in UI Adaption mode. Now click on the blank area and from the context menu choose option – Add Group

Next right click again on the group name and from the context menu choose option – Add Field

Search for the custom field and then choose that and hit Ok. The custom field will now be added to the new group

Note that, in addition to the custom field, you may see more fields in the list. They may be other custom fields or the standard fields that have not been used in the UI, but are provided by the backend

Next click on Transport on the top right and it would be included in the transport request. For now, we will save it as local object for this demo

Once done, click on Exit. Just refresh your page once. At this stage, don’t forget to publish the new changes. For this come back to your app in the adaption mode and you would notice that Publish button would now appear on the top right. Click on the that and new fields will now be published and included in the UI

Refresh the app once and now you are ready to use field.

Now go ahead and enter the values for the new project including value for new field

Click Save and Proceed and new project will be created and new field value will be saved along with it.

It is important to note here that this group has been included here for this app (Create Internal Project) while creation of new internal project. To have this group available for other related apps (based on your choice) like Plan Customer project, you need to include this in that app as well in the same fashion

As you can see below, the new field is not appearing here for this app, although it now exists in the database. Come to the Adapt UI mode once again and then include this new group for this app and Publish it


Congratulations you have just finished Key User Extensibility – Adding custom fields to the standard S/4HANA Cloud UI app using Key User tools!

Rohit Khan, S/4HANA Regional Implementation Group


Click the below link to visit the Part 4 of this blog series

Part 4: Key User Extensibility on SAP S/4HANA Cloud – Adding Custom Business Logic as a Key User


Link to part 1 and part 2 of this blog series:

Part 1: Introduction to S/4HANA Cloud Key-User Extensibility

Part 2: Key User Extensibility on SAP S/4HANA Cloud – UI Adaptions for Key User

You must be Logged on to comment or reply to a post.
  • Thanks Rohit Khan for the nice blog.

    I would like to know how can we add match code help for the custom field created through this app.

    All the underlying CDS Views are having this custom field . Underlying consumption view is not Meta Data Enhanced. So , I am not able add anything there.

    Do I have to use MPC_EXT class for this? IF Yes, do you have any reference?

    Can you please guide us on this?

    • Hello Pawan. Glad you liked the blog.

      For adding match code to the custom field, what you can do is -

      1. Create a CBO that will have the predefined values
      2. Then create a new Custom field and choose its type as - Association to Business Object.

      This way when you will add the new custom field in your UI, it will have the values in F4.

      Hope this helps!



      • Thanks a lot Rohit Khan for guiding us in the right way.

        But if we would like to provide a match code help with 6-7 Fields. Is that possible with CBO? and if we wanted to show any custom table as value help , how can we achieve this? Because our business has everything set up in the table .They just would like to see that table data as Match Code. Through custom CBO, again we need to maintain entries .


        Can you please let us know the SAP's way of achieving these things.

        • Hi Pawan,


          For now, at least in S4HC, there is no such option to show a custom table as value help. CBO is the valid option for both S4HC and S4H. However, as you are on S4H, you have full development access and you can build such a solution with the help of an ABAPer.

          Happy to help, if you have any more queries. 🙂



          • Dear Rohit Khan

            Don't you have any documentation in order to achieve this "with the help of an ABAPer" please ?

            I just can't find any how-to in order to add a data element as a reference to a UI custom field, so the matchcode automatically pops up.

            Any help would be appreciated.



          • Hello Olivier Souksamran ,

            Are you looking for adding a custom table as matchcode to the custom field added to the UI through - Custom Fields and Logic app'? Unfortunately, this feature is not supported. However, to a custom field we can associate a CBO by choosing the type = Association to Business Object.



          • Dear Rohit Khan

            Please refer to my answer :

            SCFD_EUI (SAP Note 2672370 - How to Enable Custom Fields for Usage in SAP Fiori Applicationsenables this functionnality for S4 on prem systems.

            Hope this helps.


          • Hi Olivier, Thanks for sharing this important note. Surely it will be of help to many for extensions on S/4HANA OP. Great find!



  • Hello Rohit Khan

    I have created custom fields using Custom Fields and Logic App and have added the same in Manage Purchase Contract App. All things have moved correctly to Quality systems. Everything is fine. Now we have created one more custom field and have added this new field to Manage Purchase Contract. But Post moving this Transport, Changes are not reflecting in UI of Quality. We have repeated addition of this new field again using Key User – UI Adaptation and transported this to Quality. But still no luck . We also tried to clear all caches... Still the new field is not there.  Can you please suggest me what might have gone wrong?


    Thank You Very Much…!!!

  • Hi Rohit,

    Excellent blog. Thank you for sharing the knowledge.

    I have a question here.

    I am trying to add a custom field through the custom fields App but its not showing in the backend tables in S/4.

    Can you help me out here?

    Let me know if you need any more information



    • Hi Vijay, I am assuming you are talking about the tab description within the app? If Yes - then you can through Adapt UI.

      Cheers - Rohit