docs-mintlify/admin/customization/dashboard-themes.mdx
Dashboard themes control the look and feel of dashboards — including the dashboard background, widget cards, borders, titles, and text. Cube ships with a built-in theme, and you can also create your own custom themes and reuse them across dashboards in the account.
Themes are designed and saved from the dashboard builder, then managed centrally in the admin area.
Custom dashboard themes are managed under the Manage dashboard themes permission. The built-in Admin role has this permission by default; for other users, grant the Manage dashboard themes global permission via a custom role.
A theme defines styles for the following parts of a dashboard:
| Section | Properties |
|---|---|
| Dashboard | Background color, padding |
| Widgets | Card background color, padding |
| Borders | Color, width, style, corner radius |
| Titles | Color, font size, font weight, font family |
| Text | Color, secondary color, font family, code font family |
The built-in Cube theme provides Cube's default look and is always available. It can be selected on dashboards but cannot be edited, renamed, or deleted.
Go to Admin → Customization → Dashboard Themes to see every theme available in your account. The list combines the built-in Cube theme and any custom themes saved from dashboards.
For each custom theme you can:
Themes are created from the dashboard builder rather than from this page — see Create a custom theme below.
Custom themes are saved from the dashboard builder's Styling tab.
<Steps> <Step title="Open a dashboard"> Open a dashboard in a workbook and switch to the dashboard builder. </Step> <Step title="Open dashboard options"> Click the dashboard options button and switch to the **Styling** tab. </Step> <Step title="Edit styling"> Adjust the dashboard background, widget card styles, borders, titles, and text until the dashboard looks the way you want. </Step> <Step title="Save as new theme"> Click **Save as new**, give the theme a name, and confirm. </Step> </Steps>The new theme appears in the Admin → Customization → Dashboard Themes list and becomes selectable in the Styling tab on every other dashboard in the account.
You can also tweak any styling properties on top of the selected theme — those changes are stored as overrides on the dashboard and do not modify the underlying theme.
After tweaking styling on a dashboard that uses a custom theme, you can push those changes back into the theme so every other dashboard using it picks them up.
Saving a theme updates every dashboard that uses it. Already-published dashboard snapshots keep their previous styling until they are re-published.
</Warning>Dashboards that were using the deleted theme revert to the built-in Cube theme.