Skip to content

Managing Application Themes

(Native/MDK only) As an administrator, you can manage application themes from SAP mobile service cockpit and indicate a default theme for the selected mobile app.

Themes change the appearance of the mobile client on the user's device. The mobile services server uses the settings to apply themes to the mobile app client. Each theme definition includes a light and dark version of the theme. Mobile client users can set the active theme from the device. Themes are managed at the space level.

Themes must be defined using the SAP Theme Designer and the SAP Horizon Dark / Light theme as the base. Only changes to the background color and text color can be made. The theme must be exported to the ZIP format. Once uploaded, you can set the active theme. If you decide to deselect themes, the SDK application does not get the theme from the mobile services server.

Note that for a single application cockpit (Software as a Service, SaaS), only one customized theme is available for the user to use. The theme is automatically enabled for the application once the customized theme is enabled. You can update and delete themes. If the theme is deleted, the SDK application uses the initial default theme instead of getting the theme from the mobile services server. The appearance information is cleared and you can import another theme.

Managing App Themes

You can manage all themes from a central place using SAP mobile service cockpit. Themes are created using SAP Theme Designer and the SAP Horizon Dark / Light theme as the base. You can customize the background color and text color. Export the theme to a ZIP format. The theme.zip file contains light and dark versions of the theme, including company logos in JPG format, a JSON source file for Android apps, and an NSS source file for iOS apps.

After the initial upload to App Theme Manager, to update themes you can either:

  • Use the SAP Theme Designer to modify the theme, export it to a new ZIP file, and upload it in the SAP mobile service cockpit Theme Manager.

  • Download the ZIP file that contains the NSS and JSON files from Theme Manager (provider) and Appearance (SaaS application). Modify the final processed theme ZIP directly, and upload it when finished.

To manage themes:

  1. In SAP mobile service cockpit, select Settings > App Theme Manager.

  2. View the list of themes that have been uploaded.

    Column Description
    Name The unique name associated with a theme listed in the cockpit theme list.
    ID The identifier that was assigned in the SAP Theme Designer. Note that an ID may be reused, for example, if a Theme Designer ZIP file contains both light and dark themes.
    Title The descriptive theme title, such as Custom High Contrast Morning, or Custom Evening.
    Color The light and dark color palettes defined for the theme.
    Creation Date (UTC+0000) The date and time the theme was created, in the format YYYY-MM-DD HH:MM:SS:ss.
    User Selection Whether the theme appears in the application Appearance theme list. If the theme appears in the theme list, the user can select it to make the theme active for the application.
    As Default Whether the theme should be used as the default theme. A default theme becomes the active theme for all the applications in the space.
    Actions The actions the administrator can take, such as download the theme ZIP file locally; update the theme with the latest version from SAP Theme Designer or modified locally; or delete the theme definition.
  3. Select add to add a new theme. In Add a Theme, provide the theme definition, and select Save.

    Theme Definition

    Field Description
    Theme Name Provide a descriptive name to identify the app theme. Both light and dark versions of the theme are identified with this name. You cannot change the theme name once you save.
    Light Theme Browse to select the lighter version of an app theme.
    Dark Theme Browse to select the darker version of an app theme. To learn more about implementing Android dark theme, see Dark Theme.
  4. Select download to download the theme.zip file to your local device. Optionally, you can update the files to change the themes.

  5. Select Update to update the theme using the latest version. You can:

    • Upload Theme Designer zip - select this option to upload the latest light or dark theme version.

    • Upload Processed Theme zip - select this option to upload a modified ZIP file (if you modified the files locally to change the theme definition).

  6. Select delete to delete the theme.

Managing Themes at the App Level

(Native/MDK only) You can manage the themes available for the selected application.

  1. In SAP mobile service cockpit, select Mobile Applications > Native/MDK.

  2. Select an application, then select Mobile Settings Exchange under Assigned Features (or add it first).

  3. Select Client Configuration.

  4. Under Appearance, make sure Enable Custom Theme is selected.

  5. View the list of themes that have been uploaded. The theme list reflects settings made in the App Theme Manager. See Managing App Themes.

  6. In the Active column, select the theme to be active for the selected application, and then Save. Both the light and dark versions of the theme will be available for the mobile client user to select.


Last update: October 19, 2022