Apply a report theme in Power BI Desktop

Power BI

On the Design tab, choose Import theme and pick the JSON file. Visuals you formatted by hand keep their own colours until you reset them.

What a theme file is

A report theme is a JSON file. It sets the colours and text styles for the whole report. It holds no data.

Power BI Desktop saves the theme with the report. In a PBIP project it is a file in the report folder's StaticResources/RegisteredResources, and report.json lists it.

Source: Use report themes in Power BI Desktop, Power BI Desktop project report folder.

Apply a theme file

Importing a theme removes the report's earlier theme changes. To try one without keeping it, close the report without saving afterwards.

  1. Open your report in Power BI Desktop. On the Design tab, choose Import theme.The Design tab in Power BI Desktop, with Import theme marked
  2. Pick the .json file. Desktop shows a dialog when the import works.The dialog Power BI Desktop shows after a theme file is imported
  3. Check a page. Charts, cards and tables take the theme's colours.A report page of KPI cards, a line chart, a donut with each territory's share, a bar chart and a table, in the dark Ember theme

Source: Use report themes in Power BI Desktop.

Some visuals did not change

A theme does not change a visual you formatted by hand. That visual keeps its own colours until you reset it. Resetting also removes its conditional formatting rules.

  1. Here a dark theme coloured the boxes, but the card values kept the dark text set on them by hand, so they almost vanish.A report page in a dark theme where the card values are hard to read, because their colour was set by hand
  2. Select the visual. In the Format pane, open the section that holds the colour, such as Title on the General tab. At the foot of that section, choose Reset to default. It puts back every setting in that section, not only the colour, and it is greyed where nothing was set by hand.A chart whose title is readable again after Reset to default, beside the Format pane, where Reset to default at the foot of the Title section is now greyed

Source: Use report themes in Power BI Desktop.

A dark theme left white boxes

A theme file needs only a name. Anything it leaves out comes from Desktop's base theme, which is light. A new release can update the base theme, but a report keeps its original base theme until you update it.

So a dark file that sets only the main colours can leave chart and table boxes white, with light text on them.

  1. This file set only the main colours. The chart and table boxes stayed white, and the table text can't be read.The same kind of page under a file that sets only the main colours: the KPI cards are dark, but the chart and table boxes stay white and the table text is unreadable
  2. A file that also sets visual styles and text classes colours the page, the boxes and the text.The same page under the full Midnight file: dark page and boxes, readable text and two clear series colours

Source: Create custom report themes in Power BI Desktop, Use report themes in Power BI Desktop.

The import failed

Desktop shows a dialog with the error in the file. Fix the file and import it again.

Paste the file into the JSON validator to find a syntax error.

Source: Use report themes in Power BI Desktop, Create custom report themes in Power BI Desktop.

Change it after importing

On the Design tab, Customize theme changes the colours and text of the theme in use.

Source: Use report themes in Power BI Desktop.

Go back to a built-in theme

  1. On the Design tab, open the list of themes and pick one under Power BI. A built-in theme replaces the custom one.The list of themes on the Design tab, with the built-in Power BI themes marked

Source: Use report themes in Power BI Desktop.

Themes in the Power BI service

The Design tab is in Power BI Desktop only. In the service, choose View, then Theme.

Source: Use report themes in Power BI Desktop.

Screenshots: Power BI Desktop 2.159.1231.0, 15 Nov 2026. If a step looks different in your Desktop, tell us with Feedback at the bottom of the page.

Check a project in your browser

The Power BI Report Doctor checks a PBIP project's report and model files in your browser. It does not read theme files. Nothing is uploaded.

The showcase shows five themes on one report, each with its file. See them on the report canvas.

Other guides

Sources

  • Microsoft Learn: Use report themes in Power BI Desktop. The introduction, "Apply a custom report theme JSON file", "Apply a built-in report theme", "Understand how the report uses themes" and "Considerations and limitations". Page dated 2026-08-31. Read 2026-11-15.
  • Microsoft Learn: Power BI Desktop project report folder. The folder tree, RegisteredResources ("resource files specific to the report and loaded by the user, like custom themes"), and "every resource file must have a corresponding entry in the report.json file". Page dated 2026-09-23. Read 2026-11-15.
  • Microsoft Learn: Create custom report themes in Power BI Desktop. "Create a custom theme file", "Set structural colors", "Set formatted text defaults" and "Set properties for visual types". Page dated 2026-08-31. Read 2026-11-15.

What you put into the tools never leaves your browser. We count page views and keep them for 90 days. Accept and we also remember this browser, so a return visit is not counted as new. Privacy policy