Skip to Content
Technical Articles

Adaptation Projects – it’s time for a new way to extend your Fiori Elements applications

Do you have Fiori Elements applications you use but you really wish you could extend in some way?  For instance, perhaps you have an application that uses the List Report Fiori Element and you’d like to add a couple of filters to the Smart Filter bar?  As of Web IDE version 1809, you can do that!

In Web IDE, you can create a new Adaptation Project, indicate what application you’d like to base it upon, and then easily create a new variant, using the new SAPUI5 Visual Editor.

When you create an Adaptation Project, you are creating a new variant of an existing application. The app variant refers to the original application but contains separate set of changes created in the adaptation project. Also, an application ID is defined for the variant and needs separate registration in Fiori Launchpad.

In our aforementioned use case of adding some filters to the Smart Filter of a Fiori Elements List, you would do the following steps:

  1. Create a new adaptation project
  2. Name the new project’s name and choose the application upon which you want to base the variant. A new project is created and listed in your Web IDE workspace.
  3. Right click on the project and select, SAPUI5 Visual Editor to make changes to the project.
  4. This brings up your project in the SAPUI5 Visual Editor. This editor was formerly known as the UI Adaptation Editor, but the name has changed as its abilities have grown.  In the past, you could preview the application, make changes to the properties of controls in a Fiori Elements application, see an outline view of the controls and see a list of changes that had been made.  That functionality still exists, but now you can also add code fragments and extend with a controller. 


Again, changes made via the SAPUI5 Visual Editor are saved to a Changes folder and saved in the layered repository to be applied when the application is run.

From the editor you can preview your changes and ensure everything works. Once you’re satisfied with your changes, you can easily deploy your application and, because it has a different Application ID than the original application, both the original application and the new variant’s tiles will be available.

Technical notes for this initial release:

  • Source applications must be located on an ABAP repository.
  • You can create variants of Fiori Elements based applications. In a future release we will add support of SAPUI5, “freestyle,” applications as well.

Helpful links:

SAPUI5 Visual Editor 

Adaptation Projects for Fiori Elements Applications

You must be Logged on to comment or reply to a post.
  • MMmmm…  Now I’m wondering if I can do this on-premise.   I think I can.  I just haven’t had time to play with our FiORI yet.   For new development – right now – we do it in ABAP and then link a transaction to the new tile.   I’m trying to find as much as I can – so I can start being more sophisticated.

    One step at a time.

    Thank you,


    • Hi Michelle! Yes, if you’re on-premise and have Fiori Elements applications in your ABAP repository, you can definitely use Adaptation Projects. I’d love to hear how it goes!  Best, Jessica

      • I’ll let you know.  I just watched a Teched session about Fiori Elements.  Between watching that and reading this – perhaps I can get something accomplished.

        Thank you!


  • Hi Jessica, very informative blog. I was having a questions. what is the difference between Adaptation and Extension projects in the Web IDE and will upgrade for any standard application will work for both projects ? TIA.

    • Hi Ishant,


      Thanks!  So some key features of Adaptation Projects are:

      • Extend SAP Fiori elements based apps
      • Make semantic changes to applications
      • Make changes to control properties and bindings
      • Add XML fragments to extend views
      • Assign event handlers
      • Extend I18n text
      • Move controls/sections
      • Save changes as new variants

      With adaptation projects, you do not need extension points, which is a difference from extension projects as well.

      Application variants created with adaptation projects will continue to work when the original application is updated, as the changes made in the variant are simply applied atop the original application.

      Currently, in this initial release of adaptation projects, the original application must use Object Page and/or List Page Fiori elements.  In future releases we will support applications made with the Overview Page as well as “free style” applications.