Themes and UI Updates

Themes provide the color and styling of your analytics software environment. Match your corporate colors, or use one of the default themes included with installation or upgrade.

If you're upgrading to v26.2 or later from an earlier release, the user interface has changed. Roll out this experience in your staging environment, then production environment by enabling the enhanced-experience toggle. The enhanced experience expands the classic experience with changes to navigation though the main menu and the home page.

Update your existing theme to include color properties for these new UI elements. If you don't update your classic theme (composer, modern (light) , dark) or any custom theme you've built on these classic themes, the new navigation elements will render unstyled, missing your desired accent colors, or rendering plain black text on a default white background. See User Interface Interaction With Themes.

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.

General Theme Update Workflow

1. Determine your update scenario, as laid out in Themes and UI Update Scenarios.

2. Identify your current theme by sending a GET request to the /api/customization/themes/active endpoint, then download the JSON of the theme you want to update.

3. Add or edit the properties of your JSON file. If you are updating a classic theme, see Expand a Theme to Support the Enhanced Experience. If you are updating a theme that supports the enhanced experience, see JSON File Updates.

4. Upload your updated theme. See Update a Theme or Patch a Theme.

5. Test in staging by enabling the enhanced-experience toggle, refresh your browser, then verify colors in your environment.

6. Rollout to your production environment when ready.

Safe Update and Editing Tips

1. Keep the same JSON structure and property names as in the Themes JSON File.

2. When you apply updates to your existing theme, PATCH it using the appropriate API endpoint.

3. Replace hex values with your brand colors.

4. Keep non-color style values as-is unless you specifically want to change behavior:

   • mixBlendMode

   • tabBg

5. Ensure your selected text and icon colors have enough contrast against your background colors.

6. Keep your active and hover states visually distinct from default states.

Themes and UI Update Scenarios

Depending on the version of your current instance, you may need to complete several tasks to support your roll out of an enabled enhanced experience.

User Interface Changes

When you enable the enhanced-experience toggle, the following broad changes are applied to your environment.

IFrame Access URL References

The enhanced experience user interface changes also have back end url address changes you will need to be aware of when updating your environment. Items that were in the main UI menu for Administrators and members of the Supervisor group have been reorganized into an Administration menu and Tools dropdown menu. The Switch Tenant menu has moved to a sub menu of the Profile menu option.