Use dashboard themes in the Power BI service

APPLIES TO: Power BI Desktop Power BI service

With dashboard themes you can apply a color theme to your entire dashboard, such as corporate colors, seasonal coloring, or any other color theme you might want to apply. When you apply a dashboard theme, all visuals on your dashboard use the colors from your selected theme. A few exceptions apply, described in the Considerations and limitations section of this article.

Screenshot of an example dashboard with a theme background image.

Changing the colors of the report visuals on a dashboard doesn't affect the visuals in the associated report. Also, when you pin tiles from a report that already has a report theme applied, you can choose to keep the current theme or use the dashboard theme.


To follow along, open the Sales & Returns sample dashboard.

How dashboard themes work

To get started, open a dashboard that you created or can edit. Select Edit > Dashboard theme.

Screenshot of the Edit drop down menu, highlighting the Dashboard theme option.

In the dashboard pane that appears, select one of the prebuilt themes.

Screenshot of the Dashboard theme window and dropdown menu.

In the following example, we selected Dark.

Screenshot of the dashboard with the Dark option applied.

Create a custom theme

The default theme for Power BI dashboards is Light. If you want to customize the colors or create your own theme, select Custom in the drop-down.

Screenshot of the Dashboard theme dialog box with the Custom theme option selected.

Use the custom options to create your own dashboard theme. If adding a background image, we recommend that your image is at least 1920x1080 resolution. To use an image as a background, upload the image to a public website, copy the URL, and paste it into the Image URL field.

Use a JSON theme

Another way to create a custom theme is to upload a JSON file that has settings for all the colors you'd like to use for your dashboard. In Power BI Desktop, report creators use JSON files to create themes for reports. You can upload these same JSON files for dashboards or find and upload JSON files from the Themes Gallery in the Power BI Community.

Screenshot of the Themes Gallery site.

You can also save your custom theme as a JSON file and then share it with other dashboard creators.

As with the built-in and custom options, when you upload a theme, the colors are automatically applied to all tiles on the dashboard.

  1. Hover over a theme and choose View report.

    Screenshot of a Theme Gallery report option.

  2. Scroll down and find the link to the JSON file. Select the download icon and save the file.

    Screenshot of the download icon for the JSON file.

  3. In the Power BI service, in the Custom Dashboard theme window, select Upload JSON theme.

    Screenshot of the Dashboard theme window, highlighting the Upload JSON theme option.

  4. Navigate to the location where you saved the JSON theme file and select Open.

  5. On the Dashboard theme page, select Save. The new theme is applied to your dashboard.

    Screenshot of a Dashboard with the new theme applied.

Reports and dashboards with different themes

If your report uses a different theme from the dashboard theme, in most cases, you can control whether the visual retains the current report theme or uses the dashboard theme. However, card visuals in dashboards use the 'DIN' font family, with black text. You can change the text color for all the tiles on a dashboard, including the cards, by creating a custom dashboard theme.

  • When pinning a tile to a dashboard, to keep the report theme, select Keep current theme. The visual, on the dashboard, retains the report theme, including transparency settings.

    You only see the Tile Theming options when you create the report in Power BI Desktop, add a report theme, and then publish the report to the Power BI service.

    Screenshot of the Pin to dashboard window, highlighting the Keep current theme option.

  • Try repinning the tile and selecting Use dashboard theme.

    Screenshot of the Pin to dashboard window, highlighting the Use destination theme option.

Dashboard theme JSON file format

At its most basic level, the theme JSON file has only one required line: name.

    "name": "Custom Theme"

Other than name, everything else is optional. You're free to add only the properties you specifically want to format to the theme file and continue to use the Power BI defaults for the rest.

The JSON file for dashboard theming includes:

  • name: The theme name (only required field).
  • foreground and background: Colors for the dashboard.
  • dataColors: A list of hex code to use for data in charts. You can include as few or as many colors as you want.
  • tiles: Background and color configurations for dashboards.
  • visualStyles: Granular formatting for visuals.

Here's a sample theme JSON for the default Light theme:









Considerations and limitations

  • You can't apply dashboard themes to pinned live report pages, iframe tiles, SSRS tiles, workbook tiles, or images.

  • You see dashboard themes on mobile devices, but you can only create a dashboard theme in the Power BI service.

  • Dashboard custom themes only work with tiles pinned from reports.

More questions? Ask the Power BI Community.