Manage AI/BI dashhoard workspace themes

This page explains how to create, update, and delete workspace themes for AI/BI dashboards to maintain consistent branding across your organization. For information about applying workspace themes to dashboards, see Apply a workspace theme.

Workspace theme overview

As a workspace admin, you can define a default theme for AI/BI dashboards in your workspace. When you configure a workspace theme, all new dashboards automatically inherit these settings, while existing dashboards opt in through the theme settings.

A workspace theme includes:

• Font color and family
• Canvas background color
• Widget background, border, selection color, corner radius, padding, margin, shadow, and title alignment
• Visualization axis and grid line colors
• Textbox vertical alignment
• Color palette: continuous gradient and categorical colors

The workspace theme serves as the default for new dashboards, but it is not required. Dashboard authors can select other preset themes, create custom themes, or edit the workspace theme, which converts it to a custom theme for that specific dashboard.

Requirements

To manage the workspace theme, you must be a workspace admin.

Create or update the workspace theme

To create or update the workspace theme:

1. In the admin settings, select Appearance > AI/BI > Theme.

   • If no theme exists, the button appears as Add.
   • If a theme exists, the button appears as Edit.

2. Click the button to open the full-page theme editor.

3. Use the Preview colors in toggle to preview your changes in Light mode or Dark mode.

4. Customize settings across two tabs:

   Interface tab

   • Font
     • Color: Set the font color.
     • Family: Choose a font family, or select Auto to use the default.
   • Canvas
     • Background: Set the dashboard canvas background color.
   • Widget
     • Background: Set the widget background color.
     • Border: Set the widget border color, or select Auto.
     • Selection: Set the highlight color for selected elements.
     • Corner radius: Adjust the corner radius of widgets.
     • Padding: Adjust the inner spacing of widgets.
     • Margin: Adjust the outer spacing between widgets.
     • Shadow: Adjust the widget drop shadow intensity.
     • Title alignment: Choose left, center, or right alignment for widget titles.
   • Visualization
     • Axis color: Set the axis line color, or select Auto.
     • Grid color: Set the grid line color, or select Auto.
   • Textbox
     • Vertical alignment: Choose top, middle, or bottom alignment for text widget content.

   Color palette tab

   • Continuous gradient: Choose the gradient style for continuous color scales, or select Auto.
   • Categorical colors: Define the ordered list of colors used for categorical data series. Click to add a color or to remove one.

5. Click Save to apply the workspace theme.

After you save the theme, all new dashboards automatically inherit these settings.

Delete the workspace theme

When you delete the workspace theme, new dashboards default to the Databricks theme. Existing dashboards that use the workspace theme aren't affected, and they retain the theme as a custom theme.

To delete the workspace theme:

1. In the admin settings, select Appearance > AI/BI > Theme.

2. Click Configured to open the theme editor.

3. Click Delete or the delete option in the editor.

4. In the confirmation dialog, click Remove to confirm deletion.

Theme lifecycle and dashboard impact

Understanding how workspace theme changes affect existing dashboards helps you manage theme updates without disrupting published content.

New dashboards

All new dashboards automatically inherit the workspace theme if one is configured. If no workspace theme exists, new dashboards use the default Databricks theme.

Existing dashboards

Existing dashboards can opt in to the workspace theme through the theme settings. When a dashboard author applies the workspace theme, the dashboard receives a snapshot of the current theme configuration.

Theme updates

When you update the workspace theme, existing dashboards that previously applied the workspace theme aren't automatically updated. Instead, they retain the version of the theme they had when it was last applied. This prevents unexpected visual changes to published dashboards.

Dashboard authors manually reapply the updated workspace theme to adopt the new settings.

Theme deletion

When you delete the workspace theme, existing dashboards that use it aren't affected. They automatically retain the theme as a custom theme to ensure published dashboards maintain their appearance.

Manage themes using the Settings API

Manage workspace themes programmatically using the Settings API. The API supports retrieving, updating, and deleting workspace themes.

For more information, see the Settings API reference.

What's next

• Apply a workspace theme