Skip to main content

Themes and Colors

The Holistics app allows users to create custom color palettes to be applied to their reports and dashboards.

  • Defining dashboard themes: Define themes for dashboards
  • Setting chart colors: set the colors of an individual chart as you wish
  • Color palettes: define a color palette to be used in your charts for consistency

Dashboard themes

Holistics allows you to define and customize dashboard themes.

For more info, please see: Dashboard themes

Setting chart colors

With normal charts, you can set the colors of individual chart series by going to Chart Series section.

Color palettes

Holistics lets you define custom color palettes as code and apply them consistently across charts.

Define a color palette

Defining a color palette in the palette AML file

To create a palette, go to Development > Library > Palettes and create a new .palette.aml file:

ColorPalette palette_name {
title: "Display Name" // shown in the palette picker
categorical {
colors: [
"#FF5733", // accepts hex, rgb, oklch, and other CSS color formats
"#33FF57",
"#3357FF"
]
}
}

See ColorPalette AML reference for all available parameters.

Apply a color palette

Once defined, the palette is available in the Edit or Explore modal. To apply it to a chart, click its radio button in the Visualization Settings.

Selecting a color palette in the Visualization Settings

You can also reference a palette in a dashboard theme to apply it consistently across all charts in a dashboard.

Set a default palette

You can set a palette as the default for all charts in your project in two ways:

  • GUI: Go to Project settings > Dashboard & Visualization > Default color palette and select from the dropdown.

    Setting default color palette in Project Settings
  • Code: Update the settings.aml file in your Development > settings folder:

ProjectSettings project_settings {
viz {
default_color_palette: palette_name
}
}

Legacy palettes

These palettes were created through the old Admin Settings before as-code palette support was introduced. They have a few limitations - have no AML definition, and cannot be referenced in a dashboard theme.

Legacy color palettes in Project Settings

Legacy palettes are now centralized under Project Settings in Development alongside your as-code palettes. You can view, use, and delete them, but they can no longer be edited. To replace a legacy palette, delete it and recreate it as a .palette.aml file.

FAQs

Will changing the default color palette affect existing charts using the previous default scheme?

Yes. If the default color palette is changed, existing charts using the default setting will be updated to use the new default color palette.

Can I delete the default color palette?

You cannot delete the default color palette unless you have set another palette as your default option.


Open Markdown
Let us know what you think about this document :)