Skip to Content
Technical Articles
Author's profile photo Jocelyn Dart

SAP Fiori for SAP S/4HANA – Adding Related Apps in the Fiori Apps library

Understand a new feature (released July 30th 2018) in the SAP Fiori apps reference library that enables you to combine your selected apps with their related apps, for a holistic end-to-end user experience.

In SAP S/4HANA, most individual SAP Fiori apps work together with other apps for a holistic user experience.  So when you choose to deploy a specific Fiori app for your business user and as part of your business process, you are likely to want to deploy related apps at the same time.  Now a new feature in the Fiori apps reference library makes selecting all the apps you want to implement together easier.

You can see how this works by using the Procurement Overview Page as an example.

In an Overview Page, you can navigate to other apps via:

  • The header of each card
  • A row of a List or Table card
  • The links on a Link List card
  • A quick action button on a Stacked card
  • A navigable data point on an Analytical card

In most other types of SAP Fiori apps, you also have multiple places where an app may navigate to other apps such as:

  • Links
  • Actions buttons
  • Expanding the row of a table
  • Drill down on a chart.

Up until now to select all of the apps you could navigate to – i.e. the Navigation Targets of the current app –  you needed to either:

  • Select all the apps of a Business Role as described in Role-based for app discovery and activation, or
  • Select all the apps of a Business Catalog, using the hyperlink on the Business Catalog name in the Configuration section of the Implementation Information tab, or
  • Follow each link in the Related Apps section of the app’s details and add them one by one.

Selecting all apps for a Business Role, or for a Business Catalog (a subset of a Business Role) is fine in a sandpit/exploration system or when you have a mandate to introduce maximum Fiori capability.

However sometimes you may need to carefully control the introduction of new Fiori apps, such as when you have existing users who you need to carefully transition from SAPGUI to Fiori.  If that is your need, you now have an easier way to select only the minimum apps you want to activate right now.

Start by finding and selecting your desired SAP Fiori app itself.  This app is the source app for all the navigation targets.

In this example, you can see the Procurement Overview Page app has been selected in the app list, and in the left side of the footer you can see the number of Selected apps is 1.


Now go to the Implementation Information tab and look for the Related Apps section.

NOTE: If an app doesn’t have any related apps, the Related Apps section will not appear.

Notice in the Related Apps section, there is a Related Apps table listing the related apps and their relation type. The relation type indicates whether the related app is required or optional.

Relation type Required indicates this app is necessary to correctly operate the app.

Relation type Required – UI Reuse Library indicates this app is used to provide some underlying component of the app, such as attachment services. You can find out more about reuse apps in Not Every App is a Tile.

You can see in the Procurement Overview Page example that for many of the apps the Relation Type shown is Navigation Target. This indicates a related app that is an optional target of the current app, i.e. the current app navigates to the related app via one of the options mentioned earlier (link, button, chart, etc.).

What happens if you don’t include the navigation target? Typically the navigation from the link, button, chart or whatever is simply disabled in a non-intrusive manner. For example if the navigation was from the header of a card, the user can still see the card, they just won’t get an option to navigate from the card header.

You will also notice a new Update Apps in Current Selection button in the header of the Related Apps table. Press the button and you will be asked to confirm which apps you want to add.

By default all related apps that are navigation targets are selected.

TIP: You can exclude any apps you don’t want by simply unchecking the checkbox for the app you wish to exclude.  If you change your mind you can always come back later and add it in.

Press the Update Selection button in the footer. You are given one last opportunity to confirm or cancel before the apps are added to your current selection.

Confirm by pressing Ok, and then your current selection list is updated. In the below example you can see you now have 11 apps selected.

If you want to check what is in your current selection, just press the Selected (n) button in the footer.

Once you are ready to activate the apps in your system, you can get all of the configuration details you need by using the Aggregate button just as you do when selecting apps by Business Role or Business Catalog.


A couple of last items to note.

To avoid the selection becoming too complex (and possibly even recursive), only the immediate navigation targets are added. Of course each Related App may have additional navigation targets of its own. If you want your users to navigate further, you can simply repeat the same process for any of the related target apps.

The Related Apps section in the Fiori Apps Library may also contain a Where-Used table listing all the source apps that link to the current app as a navigation target.  You won’t see the Update Apps in Current Selection button for the Where-Used list.

Find out more at Adding Related Apps to the Current Selection section of the SAP Fiori apps reference library guide.

Note: If you believe there are Related Apps missing in the Fiori apps reference library for a specific app, please raise a SAP Incident to the support component of the source app. You will also find the support component of the app in the Fiori apps reference library.  Just go to the app’s details, and on the Implementation Information tab, expand the Support section as explained in Speed up you Fiori Support Incidents


Becoming a SAP Fiori for SAP S/4HANA guru

You’ll find much more on our SAP Fiori for SAP S/4HANA wiki

Brought to you by the S/4HANA RIG

Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Niki Vandersteen
      Niki Vandersteen

      Can we add our own custom fiori application to the 'related apps' of a standard app?

      Author's profile photo Jocelyn Dart
      Jocelyn Dart
      Blog Post Author

      Hi Niki

      Ok of course you cannot add a custom app to the Fiori apps library or to the delivered SAP Business Catalog.

      However I am guessing you are really asking whether you can navigate to a custom app *in addition to*  standard delivered apps, in which case - YES!

      There are some prerequisites.

      1. Typically the related app needs to be linked either via a target mapping using a Semantic Object + Action, or alternatively linked via a List of Links dialog based on the Semantic Object only.

      P.s. there are some additional variations possible for certain types of apps, e.g. via configuration of a Smart Business KPIs semantic object/action links.

      2. You need to copy the SAP delivered Business Catalog and replace (if Semantic Object + action) or add (if Semantic object only) your custom app in the list of target mappings of the catalog.

      For best reuse, we recommend creating your own custom Technical Catalog with your custom tiles & target mappings, and referencing the tile/target mapping from the technical catalog to your business catalog.

      P.s. Don't forget to mark which device types (desktop, tablet, phone) can use your custom app

      P.P.S. You might need to adjust the parameters of the target mapping to pass data across!

      3. The business user needs to be authorized to use your custom app.

      That's the main steps.

      So really it's a little bit of configuration... and some testing as always 🙂

      Good luck!


      Author's profile photo Fabian Gagel
      Fabian Gagel

      Hello Jocelyn,

      I am not quite sure about how to use your above mentioned description. What we want to achieve is adding a custom app to the "Related Apps" button within a fiori app. So when a user clicks on related apps button our custom app should appear in the list and the user can navigate to it.

      Could you please provide some more details on how to achieve this after our custom app has been added to the business catalogue?

      Thanks and best regards,


      Author's profile photo Jocelyn Dart
      Jocelyn Dart
      Blog Post Author

      Ok so this blog post is about Related Apps in the SAP Fiori apps library.

      What you may find more helpful for your use case is my other blog post about Adjusting insight to action app to app navigation

      Have a read to see if this is what you are looking for, and if you still have questions please comment on the other blog.

      All the best.

      Author's profile photo Roberto P
      Roberto P

      Hello Fabian,

      Sorry for bothering you.

      In these years have you found a solution to your request?


      Author's profile photo Fabian Gagel
      Fabian Gagel

      Hello Roberto,

      I did actually not follow up on this topic but I can imagine how this might work. When you have an app A with target mapping "Abc-display" you can add related apps B and C by giving them the same semantic object "Abc" with a different action of course. When you put these in the same catalogue the users should be able to use this feature. I hope this helps.

      Best regards,

      Author's profile photo Roberto P
      Roberto P

      Thanks for the quick response after all these years.

      Have a good day.

      Author's profile photo Niki Vandersteen
      Niki Vandersteen

      That was the answer I was looking for. Thanks!


      Now the testing can begin 🙂

      Author's profile photo Ales Erban
      Ales Erban

      Hi Jocelyn Dart,

      I have just "turned on" the Procurement Overview app WITHOUT the related apps. I was expecting it to just show the analytic data without the clickable headers/contents of the cards. However when a user clicks a header now we get an error. Is there something we are missing in the configurations, to actually disable the "clickability" when the related app is not "turned on"?


      Thank You in advance for your help!



      Author's profile photo Jocelyn Dart
      Jocelyn Dart
      Blog Post Author

      Hi Ales

      Ok so I suspect what has happened here is that Fiori still thinks you are authorized to use the navigation because you have a target mapping for the related Semantic Object + Action assigned to your assigned business catalog & business role.  So it’s only when it correctly tries to launch the apparently permitted app that it discovers there is a problem.

      So best option is to copy the standard business catalog to the customer namespace, remove the target mappings you don’t want used, and in your business role replace the SAP business catalog with your custom catalog

      By the way there’s now a mass maintenance tool you can use for this called Fiori Content Manager (check the SAP Notes). Or you can make those changes in the Launchpad Designer


      Author's profile photo Ales Erban
      Ales Erban

      Hi Jocelyn Dart,


      Thank You for your answer. Now I have a very simple catalog which only has 2 Target Mappings.

      One is to display the Procurement Overview Page ("Procurement-displayOverviewPage")

      And another to display the KPI tile on it ("PurchaseContract-manage"). The KPI tile will not show up at all if I would not add this Target Mapping.


      Now, when I click the header of the KPI tile or an Item, it actually tries to access the mentioned Target Mapping ("PurchaseContract-manage") except it adds some URL parameters.

      Thus removing the Target Mapping is probably not the solution here 🙂







      Author's profile photo Jocelyn Dart
      Jocelyn Dart
      Blog Post Author

      Hi Ales

      The parameters are context that are added automatically and so are not relevant to this problem. Giving the target mapping is the authorization to see the card and navigate to the underlying app. So the system expects the underlying app to be available.

      The underlying app is considered part of the functionality that is being granted... i.e. .why would you give a card and yet not allow the user any way to act upon the insights the card is giving him/her, or even to see the details of the problem?!

      If for some reason you really only want to give the card, you can change the target mapping to point to some other app or URL. However I would recommend you discuss with your business stakeholders what they are trying to achieve by this approach.