/
Report Themes

Report Themes

Introduced in the 2025_03 release, we are now able to define a theme for a report in several ways, with the theme settings following a cascading priority order. Below is a summary of the available options and their priority:

 

Priority (Highest to Lowest):

Prior version to 2025_03:

  1. Global system theme

  2. pi internal theme

If you are using a version before 2025_03, please see our Controlling Report Themes (Pre 2025_03) page for further instructions.

 

From the 2025_03 version:

  1. Report-level theme

  2. Global reports theme

  3. Global system theme

  4. pi internal theme

 

N.B - this priority will apply to all reports available in the dashboard, including report exports and reports returned from Drill to API functionality.

 

Explanation of Options:

  • Report-level theme:
    A theme that applies to an individual report. Set in the report editor either by entering a theme name manually or selecting one from the available dropdown. If a theme name is present, the validation process will check whether the theme exists in the system. If the theme doesn't exist, a warning will be displayed in the UI.

report_editor.png

  • Global reports theme:
    A theme that applies to all reports within the dashboard. Set by PI_STYLES_REPORTS system variable in the "Global Variables" section under Dashboard Configuration.

global_reports.png

  • Global system theme:
    A theme that applies to the whole dashboard, including the reports. Set by PI_STYLES system variable in the ‘Global Variables’ section under Dashboard Configuration.

system.png

  • pi internal theme:
    A fallback theme used when no user-defined themes are set in the dashboard.