> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cube.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Chart palettes

> Create custom color palettes so charts across your account stay consistent and on-brand.

Chart palettes control the colors used in chart visualizations across [workbooks][ref-workbooks] and [dashboards][ref-dashboards]. Cube ships with a set of built-in palettes, and you can also define your own custom palettes — for example, to match your company brand — and reuse them on any chart in the account.

Custom palettes are managed centrally and are available across every deployment in the account.

[ref-workbooks]: https://docs.cube.dev/docs/explore-analyze/workbooks

[ref-dashboards]: https://docs.cube.dev/docs/explore-analyze/dashboards

## Requirements

Custom chart palettes are managed under the **Manage chart palettes** permission. The built-in **Admin** [role][ref-roles] has this permission by default; for other users, grant the **Manage chart palettes** global permission via a [custom role][ref-custom-roles].

[ref-roles]: https://docs.cube.dev/admin/users-and-permissions/roles-and-permissions.md

[ref-custom-roles]: https://docs.cube.dev/admin/users-and-permissions/custom-roles.md

## Browse palettes

Go to **Admin → Customization → Chart palettes** to see every palette available in your account. The list combines:

* **Built-in palettes** shipped with Cube — these can be used in charts but cannot be edited or deleted.
* **Custom palettes** created in your account — these can be edited, renamed, and deleted.

Each row shows the palette name and a preview of its colors.

## Create a custom palette

1. Go to **Admin → Customization → Chart palettes**.
2. Click **Create chart palette**.
3. Give the palette a **Name** and provide its colors as a comma-separated list of hex codes (for example, `#1F77B4, #FF7F0E, #2CA02C`).
4. Click **Create**.

The new palette appears in the list immediately and becomes selectable in the chart styling controls.

## Edit a custom palette

1. Go to **Admin → Customization → Chart palettes**.
2. Click the row action on the palette you want to change and select **Edit**.
3. Update the name or colors and click **Save**.

Existing charts that use the palette pick up the new colors automatically.

## Delete a custom palette

1. Go to **Admin → Customization → Chart palettes**.
2. Click the row action on the palette you want to remove and select **Delete**.

Charts that were using the deleted palette fall back to the [default palette](#set-a-default-palette).

## Set a default palette

Charts that don't pick a palette use the account's default palette. Out of the box, it is the built-in **Default** palette. To use a custom palette instead:

1. Go to **Admin → Customization → Chart palettes**.
2. Click the row action on a custom palette and select **Set as default**.

A star marks the default palette in the list. It also sets the chart colors of [apps](https://docs.cube.dev/admin/customization/app-theme.md#apps). To go back to the built-in **Default** palette, select **Clear default** on the current default. You can't delete the default palette.

## Apply a palette to a chart

Palettes are applied per chart from the chart's styling controls:

1. Open a workbook and select a chart.
2. Open the **Style** panel for the chart.
3. Use the **Palette** dropdown to pick a built-in or custom palette.

The dropdown shows palettes that match the chart's color encoding:

* **Discrete** palettes appear when the color encoding is categorical (for example, color by `status` or `category`).
* **Continuous** palettes appear when the color encoding is quantitative or temporal (for example, color by `total_sale_price` or `created_at`).

If no palette is explicitly selected, charts use the [default palette](#set-a-default-palette).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.