From b1e022f5c24666d74a1b6bf80f844a173e544ae5 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 8 May 2026 15:01:35 +0000 Subject: [PATCH 1/4] docs: document color palette hierarchy across project, space, dashboard, and chart levels --- ...omizing-the-appearance-of-your-project.mdx | 28 +++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/references/workspace/customizing-the-appearance-of-your-project.mdx b/references/workspace/customizing-the-appearance-of-your-project.mdx index 5233bbc3..644cea38 100644 --- a/references/workspace/customizing-the-appearance-of-your-project.mdx +++ b/references/workspace/customizing-the-appearance-of-your-project.mdx @@ -32,3 +32,31 @@ You can always come back to this page to change the default palette. The next time you build a chart, it will default to using these colors for the series, unless you override them in the chart config. ![](/images/references/workspace/customizing-the-appearance-of-your-project/use-color-palette-chart.png) + +## Color palette hierarchy + +Palettes themselves are always managed at the organization level, but you can pick a specific palette at lower levels to override the default. When a chart is rendered, Lightdash resolves which palette to use by walking up the following chain and stopping at the first override it finds: + +1. **Chart** — a per-chart palette set from the chart's Series tab (cartesian and pie) or Steps tab (funnel). +2. **Dashboard** — a palette set on the dashboard from its settings modal. Applies to all tiles in the dashboard unless an individual chart overrides it. +3. **Space** — a palette set on a space. Nested spaces walk up through their parent spaces, so a child space inherits its nearest ancestor's palette before falling through to the project. +4. **Project** — a palette set on the project from `Project settings` --> `Appearance`. Applies to every chart in the project unless something below overrides it. +5. **Organization** — the organization's active palette (set on `Organization settings` --> `Appearance`). This is the final fallback. + +In short: **chart > dashboard > space (and parent spaces) > project > organization**. + +### Setting a project-level palette + +Project admins can pick one of the org's palettes for a project under `Project settings` --> `Appearance`. The picker is read-only — to add or edit palettes themselves, go to `Organization settings` --> `Appearance`. Charts in the project use the project palette and fall back to the org's active palette when none is set. + +### Setting a space-level palette + +When creating or editing a space, you can pick a palette underneath the space name. The palette applies to every chart in that space and to any nested spaces below it that don't set their own palette. If you leave it unset, the space inherits from its parent space (when nested) or from the project. + +### Setting a dashboard-level palette + +Open the dashboard settings modal to pick a palette for a dashboard. Tiles in the dashboard render with the dashboard's chosen palette unless the chart itself sets a per-chart override. + +### Setting a chart-level palette + +In the chart editor, the palette picker is at the top of the **Series** tab (cartesian and pie charts) and the **Steps** tab (funnel charts). The preview reflects the staged palette before you save; the override only persists when you click **Save changes**. From 68726c100d8a2cd253a4da0b0af0325b3b387947 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 8 May 2026 15:23:28 +0000 Subject: [PATCH 2/4] docs: note embed/SDK palette takes precedence over chart-level override --- .pr-body.md | 9 +++++++++ ...customizing-the-appearance-of-your-project.mdx | 15 ++++++++------- 2 files changed, 17 insertions(+), 7 deletions(-) create mode 100644 .pr-body.md diff --git a/.pr-body.md b/.pr-body.md new file mode 100644 index 00000000..56c94aeb --- /dev/null +++ b/.pr-body.md @@ -0,0 +1,9 @@ +Adds documentation for the new color palette resolution chain to the existing **Color palettes** appearance page. + +Hierarchy (first override wins): **chart > dashboard > space (walks up parents) > project > organization**. + +Covers where each level is configured: +- Project: Project settings → Appearance ([#22590](https://github.com/lightdash/lightdash/pull/22590)) +- Space: space create/edit modal, with nested-space walk-up ([#22615](https://github.com/lightdash/lightdash/pull/22615)) +- Dashboard: dashboard settings modal ([#22794](https://github.com/lightdash/lightdash/pull/22794)) +- Chart: Series tab (cartesian/pie) and Steps tab (funnel) ([#22769](https://github.com/lightdash/lightdash/pull/22769)) \ No newline at end of file diff --git a/references/workspace/customizing-the-appearance-of-your-project.mdx b/references/workspace/customizing-the-appearance-of-your-project.mdx index 644cea38..9b2fb148 100644 --- a/references/workspace/customizing-the-appearance-of-your-project.mdx +++ b/references/workspace/customizing-the-appearance-of-your-project.mdx @@ -37,13 +37,14 @@ The next time you build a chart, it will default to using these colors for the s Palettes themselves are always managed at the organization level, but you can pick a specific palette at lower levels to override the default. When a chart is rendered, Lightdash resolves which palette to use by walking up the following chain and stopping at the first override it finds: -1. **Chart** — a per-chart palette set from the chart's Series tab (cartesian and pie) or Steps tab (funnel). -2. **Dashboard** — a palette set on the dashboard from its settings modal. Applies to all tiles in the dashboard unless an individual chart overrides it. -3. **Space** — a palette set on a space. Nested spaces walk up through their parent spaces, so a child space inherits its nearest ancestor's palette before falling through to the project. -4. **Project** — a palette set on the project from `Project settings` --> `Appearance`. Applies to every chart in the project unless something below overrides it. -5. **Organization** — the organization's active palette (set on `Organization settings` --> `Appearance`). This is the final fallback. - -In short: **chart > dashboard > space (and parent spaces) > project > organization**. +1. **Embed / SDK** — when a chart is rendered through an embedded dashboard or the React SDK, a palette passed in via the embed token or SDK config takes precedence over every other level, including a per-chart override. See [Embedding with React SDK — Color palettes](/references/react-sdk#color-palettes). +2. **Chart** — a per-chart palette set from the chart's Series tab (cartesian and pie) or Steps tab (funnel). +3. **Dashboard** — a palette set on the dashboard from its settings modal. Applies to all tiles in the dashboard unless an individual chart overrides it. +4. **Space** — a palette set on a space. Nested spaces walk up through their parent spaces, so a child space inherits its nearest ancestor's palette before falling through to the project. +5. **Project** — a palette set on the project from `Project settings` --> `Appearance`. Applies to every chart in the project unless something below overrides it. +6. **Organization** — the organization's active palette (set on `Organization settings` --> `Appearance`). This is the final fallback. + +In short: **embed/SDK > chart > dashboard > space (and parent spaces) > project > organization**. ### Setting a project-level palette From d461e291770c25d57a4b7cc52d31d3f66229a9fd Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 8 May 2026 15:24:44 +0000 Subject: [PATCH 3/4] docs: remove "Use the palette in a chart" section --- .../customizing-the-appearance-of-your-project.mdx | 6 ------ 1 file changed, 6 deletions(-) diff --git a/references/workspace/customizing-the-appearance-of-your-project.mdx b/references/workspace/customizing-the-appearance-of-your-project.mdx index 9b2fb148..0ea345ed 100644 --- a/references/workspace/customizing-the-appearance-of-your-project.mdx +++ b/references/workspace/customizing-the-appearance-of-your-project.mdx @@ -27,12 +27,6 @@ You can always come back to this page to change the default palette. ![](/images/references/workspace/customizing-the-appearance-of-your-project/use-theme.png) -## Use the palette in a chart - -The next time you build a chart, it will default to using these colors for the series, unless you override them in the chart config. - -![](/images/references/workspace/customizing-the-appearance-of-your-project/use-color-palette-chart.png) - ## Color palette hierarchy Palettes themselves are always managed at the organization level, but you can pick a specific palette at lower levels to override the default. When a chart is rendered, Lightdash resolves which palette to use by walking up the following chain and stopping at the first override it finds: From 83691a9179cb777176abd033d0cac62962e3e829 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 8 May 2026 15:28:01 +0000 Subject: [PATCH 4/4] chore: remove stray .pr-body.md scratch file --- .pr-body.md | 9 --------- 1 file changed, 9 deletions(-) delete mode 100644 .pr-body.md diff --git a/.pr-body.md b/.pr-body.md deleted file mode 100644 index 56c94aeb..00000000 --- a/.pr-body.md +++ /dev/null @@ -1,9 +0,0 @@ -Adds documentation for the new color palette resolution chain to the existing **Color palettes** appearance page. - -Hierarchy (first override wins): **chart > dashboard > space (walks up parents) > project > organization**. - -Covers where each level is configured: -- Project: Project settings → Appearance ([#22590](https://github.com/lightdash/lightdash/pull/22590)) -- Space: space create/edit modal, with nested-space walk-up ([#22615](https://github.com/lightdash/lightdash/pull/22615)) -- Dashboard: dashboard settings modal ([#22794](https://github.com/lightdash/lightdash/pull/22794)) -- Chart: Series tab (cartesian/pie) and Steps tab (funnel) ([#22769](https://github.com/lightdash/lightdash/pull/22769)) \ No newline at end of file