Power BI theme JSON explained

A Power BI theme is a single JSON file. Power BI reads it when you import it and uses it as the default look for every visual in the report. Knowing its structure helps you fix a theme that will not import, or change one detail without starting over.

The smallest theme that works

{
  "name": "My theme",
  "dataColors": ["#273C75", "#8C7AE6", "#40739E", "#E1B12C"],
  "background": "#FFFFFF",
  "foreground": "#22252A",
  "tableAccent": "#273C75"
}

This alone changes the colors of series in charts, the default text color and the accent color of tables.

Top-level colors

  • dataColors: the series colors, used in order. The first series gets the first color.
  • background, foreground, tableAccent: the base background, main text and table accent.
  • good, neutral, bad: sentiment colors, used for example by KPI visuals and waterfall charts.
  • maximum, center, minimum, null: the diverging colors that conditional formatting color scales start from.
  • foregroundNeutralSecondary, backgroundLight, backgroundNeutral and similar: structural colors for secondary text, gridlines and other details.

textClasses

Sets font family, size and color for groups of text. The four main ones are callout (big numbers in cards), title, header and label.

"textClasses": {
  "title": { "fontFace": "Segoe UI Semibold", "fontSize": 12, "color": "#22252A" },
  "label": { "fontFace": "Segoe UI", "fontSize": 10, "color": "#6B7280" }
}

visualStyles

This is where most of the detail lives. The structure is always visual → style → card → list of properties. The visual "*" means all visuals, and page is the report page itself.

"visualStyles": {
  "*": { "*": {
    "background": [{ "color": { "solid": { "color": "#FFFFFF" } }, "transparency": 0 }],
    "border": [{ "show": true, "color": { "solid": { "color": "#E5E7EB" } }, "radius": 8 }]
  }},
  "page": { "*": {
    "background": [{ "color": { "solid": { "color": "#F5F6F7" } }, "transparency": 0 }]
  }}
}

Colors inside visualStyles are always written as {"solid":{"color":"#RRGGBB"}}, and every card is a list, even with one item. Most import errors come from breaking one of those two rules.

Checking a theme

Microsoft publishes the official JSON schema for report themes in the powerbi-desktop-samples repository on GitHub. Editors such as VS Code can use it to flag mistakes as you type. Themes downloaded from Temat Studio are checked against that schema, and the JSON tab shows the full file if you want to read or copy it.

Try it in Temat Studio

Free, no account, runs in your browser.

Open the app →