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,backgroundNeutraland 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.
All guides
- How to create a dark theme in Power BI
- How to use your company colors in Power BI
- Why your Power BI theme doesn't change every visual
- Why your Power BI theme doesn't change SVG and custom visuals
- How to add icons to a Power BI report
- Custom icons in Power BI tables: conditional formatting with your own icons
- How to share a Power BI theme with your team