How Do You Change the Background Image in Power BI?

How Do You Change the Background Image in Power BI?

You change it in the Format pane, but the first problem is that Power BI has two background settings and most guides only talk about one of them.

One is Canvas background, which sits behind your visuals on the report page itself. The other is Wallpaper, which fills the grey area around the page.

Both accept an image. They look almost identical in the Format pane and they behave completely differently in exports, in the mobile app and in a report theme.

The second problem is that Microsoft documents them unevenly. The main Power BI design page gives full step-by-step instructions for wallpaper and, for canvas background, names the dropdown and stops.

This guide fills that gap, and flags every place where Microsoft's own pages disagree with each other.

What is the short answer?

Open the report page you want to change, click an empty area of the canvas so that nothing is selected, then open the Format pane. You will see a Canvas background section and a Wallpaper section.

Expand the one you want, choose Add file or Browse, pick your image, and then drop the transparency value, because the default will hide it.

If you are working from the ribbon instead, Microsoft's Design ribbon page spells out the mapping: "Page background opens Canvas background in the Format pane. Wallpaper opens Wallpaper in the Format pane."

That sentence is worth reading twice. The ribbon calls it Page background. The Format pane calls it Canvas background.

Microsoft's own documentation uses both names for the same setting, on pages published a year apart, which is the single biggest reason people searching for this cannot find a tutorial that matches their screen.

Reporting dashboards only pay off if the numbers behind them are trustworthy. Get a free SEO and analytics audit and see what your tracking is actually capturing.

Canvas background and wallpaper are not the same thing

Microsoft's "Use visual elements to enhance Power BI reports" page draws the distinction clearly, and it is the only place that does.

What each one covers

The page states that "the area in the canvas where you can place visuals is referred to as the report page and, in the Format pane, can be modified using the Canvas background dropdown," and separately that "you can format the gray area outside your report page using wallpaper."

Which one sits in front

The layering is documented explicitly: "The report page is always in the foreground (when compared to the wallpaper), while the wallpaper is behind it and the furthest-back element on the report page."

So the canvas background is the layer your visuals sit directly on top of. The wallpaper is the frame around it, and on a wide monitor with a 16:9 report page, the wallpaper is often the larger visible area of the two.

What Microsoft never says

Wallpaper can be set per page or across a whole report, in Microsoft's words "on a per-report-page basis or have the same wallpaper for every page." What it never publishes anywhere is a decision rule. There is no page that says use canvas background for this and wallpaper for that.

The only comparative remark we could find in Microsoft's own material is a stylistic aside in an old Power BI Desktop feature summary about a white wallpaper feeling nicer than a grey one. For a setting this visible, that is a striking gap.

Why your background image looks washed out

This is the most common complaint about the feature, and the cause is a documented default that Microsoft never connects to the symptom.

The visual elements page states the defaults outright: "All new reports have the following default settings: The report page is set to white and its transparency is set to 100%. The wallpaper is set to white and its transparency is set to 0%."

A canvas background at 100% transparency is invisible. Add an image to it and nothing appears to happen. Nothing is broken; the layer is simply fully transparent, and you have to pull the transparency slider down before the image renders.

Microsoft states the 100% default on one page and never warns, on any page we could find, that adding an image to that layer therefore produces no visible result until you change it.

There is a related tell that confirms you are on the right layer.

Microsoft documents that "when you set your page background to greater than 50% transparency, a dotted border appears while you're creating or editing your report to show you the boundary of the report canvas border." If you see that dotted outline, you are editing the canvas, not the wallpaper.

Working out whether a dashboard is telling the truth? Start with a free audit and get an outside read on your data before you design around it.

Normal, Fit and Fill: documented in the wrong place

Once an image is in, Power BI offers an image-fit choice. The option names are real, and the only first-party page that names them is a page about exporting to PDF.

That page warns that "you might see a distorted image in the export if you use the Normal or Fill options for the Page Background. For best results, use the Fit option."

So Microsoft names Normal, Fill and Fit for page backgrounds exactly once, inside an export caveat, and defines none of them.

Meanwhile the documentation for the separate Image visual fully defines a different and only partly overlapping set: Fit, Fill, Center and Stretch, with Fit described as scaling "the image to fit entirely within the visual bounds while preserving the aspect ratio." There is no Normal in that set.

Two overlapping vocabularies, one of them undefined, is a reasonable summary of this corner of the product.

The practical advice is simple: choose Fit unless you have a specific reason not to, because it is the only option Microsoft has ever recommended in print.

What file types and sizes are supported?

No page we could find documents either one. There is no published list of supported image formats for canvas background or wallpaper, and no maximum file size or resolution anywhere.

The nearest first-party format list sits on a page about OneLake image and map files, which states that "Power BI supports BMP, JPG, JPEG, GIF, PNG, and SVG image URLs" — but that page is about image URLs in visuals and does not mention page background or wallpaper at all.

Treating it as the background format list is an assumption, not a documented fact.

The only performance guidance is a general warning that large images increase the time required to render a report page, with no threshold attached.

In practice, exporting a PNG at roughly the page dimensions rather than at full camera resolution is the sensible default.

Can you do this in the Power BI Service?

Possibly, and the documentation will not settle it for you. The visual elements page carries an "Applies to" banner naming both Power BI Desktop and the Power BI service.

But the page about using Report view in the service does not contain the words background, wallpaper or Format pane anywhere, and the Design ribbon only appears in the service when the new ribbon preview is turned on.

So editing this setting in the browser is implied by a banner and documented nowhere. Set it in Desktop and republish.

One trap to avoid while searching: Microsoft has a page titled "Add a Background Image to a Power BI Paginated Report" that looks like the answer and is not.

It applies to Power BI Report Builder only and exposes a completely different option set, including a BackgroundRepeat property with Default, Repeat, RepeatX, RepeatY and Clip values. None of that exists in Desktop.

Can a report theme set a background image?

No, as far as Microsoft documents it. Custom report theme JSON files support background color classes — background, secondaryBackground, backgroundLight, backgroundDark and backgroundNeutral — and none of them takes an image.

The Theme pane in the product is equally explicit about being color-only. Microsoft's visual defaults page describes it as "Canvas background: Change the background color across all pages" and "Wallpaper: Change the wallpaper color across all pages."

The absence is worth naming plainly: theme JSON gives you background color across a whole report, and there is no documented property for a background image.

That means a branded image background is a per-page manual step, repeated for every page, with nothing in the theming system to carry it.

Branded dashboards are worth little if the underlying measurement is wrong. Get a free audit and find out where your analytics setup is costing you.

What breaks when you use a background image

This is where the two settings diverge sharply, and where most of Microsoft's genuinely useful writing on the topic lives.

Mobile layout. Microsoft's mobile layout page contains one sentence on this, and it is blunt: "The engine can't handle background images." There is no further guidance for canvas background or wallpaper on phones.

PDF export. The export page states that the feature "doesn't export any wallpaper you apply to the report," and warns that "if the text in your report is light or white, it's difficult to read." A dark wallpaper with white labels therefore exports as white text on white paper.

PowerPoint export. Microsoft's recommendation here is to not do it: "Background images are cropped with the chart's bounding area. We recommend that you remove background images before you export to PowerPoint."

Accessibility. Microsoft's accessibility guidance for Power BI does not mention background images at all. It covers text contrast, citing WCAG 2.1 success criterion 1.4.3 and a minimum contrast ratio of 4.5:1 for text against its background, but says nothing about a busy photographic background sitting behind data labels. The requirement still applies; Microsoft simply never ties it to this feature.

Before you redesign a dashboard, make sure it is measuring the right things. Get a free analytics audit and fix the data layer first.

When is a background image the right choice?

Rarely as decoration, often as structure. A flat image that draws panel outlines, section dividers and a header band behind otherwise transparent visuals is the pattern that actually works, because it buys layout control that Power BI's own containers do not offer.

A photograph behind charts almost never survives contact with the 4.5:1 contrast requirement, the PDF export caveat and the mobile limitation at the same time.

The alternative worth considering first is simply a shape. Insert a rectangle, set its fill, and send it to the back. It respects themes, survives export, and can be positioned per section rather than per page.

It is the same argument we made about using the right native element in our guide to adding icons in a Power BI dashboard — the built-in object usually beats the imported asset.

Final thoughts

Changing a background image in Power BI is a two-minute job once you know that there are two settings, that the ribbon and the Format pane call one of them different things, and that a 100% transparency default will hide your image until you change it.

What makes the topic harder than it should be is how much of it is undocumented rather than unsupported.

Microsoft gives steps for wallpaper and not for canvas background, names Normal, Fit and Fill only inside a PDF caveat without defining any of them, publishes no file-type list and no size limit, and offers no decision rule, no theme-JSON image property and no accessibility guidance for images behind visuals.

Design around the documented edges rather than the ideal case. Use Fit, keep the image flat, lower the transparency deliberately, strip backgrounds before a PowerPoint export, and check the mobile layout before anyone else does.