Skip to main content

Manage User Interface Themes

  • Updated

Manage User Interface Themes

Composer includes support for color themes that help you define the colors of your user interface. Match to your corporate colors, or use one of several built in themes.

Important: In this release, when you enable the Enhanced Experience user interface, users see changes to workflows and the user interface. The classic themes require updates to allow your users to see a consistent color scheme. For more information, see User Interface Themes: v26.2 and Later and Themes and UI Updates.

You can define and use your own color themes. To manage themes, a Composer user must be assigned to a group with the Administer Themes (ROLE_ADMINISTER_THEMES) privilege enabled. See Group Privilege Reference.

Note: You can only tailor theme colors. Other tailoring properties (such as fonts or font sizes) should not be changed.

Themes are defined, controlled, and managed using the customization/themes API endpoint. Any changes you make to the theme are applied for all users in the tenant account. Users in other tenant accounts are not affected.

You can specify a master theme in the theme JSON using the masterThemeID property to define properties you want have inherited by a custom theme. Using a master theme is optional. Only Composer-supplied themes can be used as a master theme. See Supplied Themes.

User Interface Themes: v26.2 and Later

Beginning with the release of v26.2, you have access to a refreshed user interface for use in your environment. For information on previous releases, see User Interface Themes: Earlier Releases.

Your home page, main menu, and overall user interface have been enhanced with a new look, feel, and fresh color theme. We call it the Enhanced Experience. It modernizes and expands the Classic Experience that has defined your embedded analytics experience.

The home page updates bring together changes that make it easier for users to access sources, visuals, libraries, and administrative features.

The main menu has been reimagined, so your users and administrators can quickly access the features, information, tenants, or other tools they need.

For more information, see Home Page and The Main Menu.

Which interface will I see when I implement 26.2?

No matter your transition path, when implement v26.2 in your environment, your custom theme is honored. When you are ready to stage and then roll out the layout changes to your users, enable the enhanced-experience toggle. See Server-Level Variables.

  • The Enhanced Experience If you are transitioning from Symphony 26.1 or earlier, you will see the enhanced experience layout and colors you are already using.

  • The Classic Experience If this is a fresh installation of v26.2 in your environment, you will see the classic experience layout and default composer color theme. Enable the enhanced-experience toggle in your staging environment to try it out, then roll it out to your users.

  • The Classic Experience If you are transitioning from Composer 26.1 or earlier and using any previous color theme (composer, modern, dark), you will see the classic experience layout and composer color theme. Enable the enhanced-experience toggle in your staging environment to try it out, then roll it out to your users.

  • The Classic Experience If you are transitioning from Composer 26.1 or earlier and using a custom color theme, you will see the classic experience layout with your colors. Enable the enhanced-experience toggle in your staging environment to see what it looks like. You will need to add information to your existing color theme to expand it to include the new user interface elements before you roll it out to your users. See User Interface Themes: v26.2 and Later and Themes and UI Updates.

Caution: Update your custom theme and enable the enhanced-experience toggle before upgrading past version 26.2. The enhanced homepage and navigation will become the standard experience for all users in the near future. We recommend making these updates now to ensure a smooth transition.

Supplied Themes

When you install or upgrade to version 26.2 or later, five themes are provided. You can switch to (activate) a different theme when needed using the provided API.

API documentation is provided in your environment at this link: https://<composer-URL>/composer/swagger-ui.html.

  • Two of these themes fully support color and customization for environments that enable the enhanced-experience user interface toggle: d+a_light and __platform__ (for environments transitioning from Symphony that previously used the platform theme).

  • Three themes support the classic experience from earlier releases: composer, modern (light) and dark. The composer theme is used by default in v26.2 and earlier releases when you install v26.2 or upgrade to v26.2 to ease the transition.

Caution: Update your custom theme and enable the enhanced-experience toggle before upgrading past version 26.2. The enhanced homepage and navigation will become the standard experience for all users in the near future. We recommend making these updates now to ensure a smooth transition.

User Interface Interaction With Themes

The d+a_light and __platform__ themes have definitions for the full range of user interface changes introduced when you enable the enhanced-experience toggle.

You will need expand and update your classic theme colors to accommodate the new interface objects.

This chart explains that classic composer themes do not have info to handle UI elements such as home and left navigation

Additional information about themes can be found here:

User Interface Themes: Earlier Releases

Supplied Themes

When Composer is installed, three themes are provided: composer, modern (light) and dark. The composer theme is used by default. You can switch to (activate) a different theme when needed.

See Activate a Theme.

API documentation is provided in your environment at this link: https://<composer-URL>/composer/swagger-ui.html.

Related articles

Comments

0 comments

Please sign in to leave a comment.