Power BI

Renders a Power BI report in an iframe on the page. If nothing is configured yet it shows a 'Power BI not configured' empty state asking for a URL, embed code, or report ID.

The macro is inserted straight from the editor by typing a slash command and choosing it from the list.

You can also skip the macro browser: paste a Power BI or Fabric embed link on its own line and the macro is created for you. See Embed a Power BI report in Confluence.


#Settings

Setting

Values

Default

What it changes

Embed URL, iframe code, or report ID

An app.powerbi.com or app.fabric.microsoft.com link in the /reportEmbed or /view form, the iframe code from Power BI, or a bare report ID

empty string

Which report the frame shows. A bare report ID becomes a secure app.powerbi.com link. See Three ways to point at a report.

Width

A CSS length such as 800px or 60%; a bare number is pixels

100%

The frame's width, capped at the page column.

Height

A CSS length such as 700px; a bare number is pixels

450px

The frame's height, at least 200 pixels. The frame does not scroll, so a taller report is cut off. See Resize a Power BI report in Confluence.


#Messages the macro can show

Message

What happened

Power BI not configured. Paste a Power BI URL, embed code, or report ID.

The field is empty, or what was pasted is not an embed link the macro understands.

A Microsoft sign-in or no-access message inside the frame

Power BI is refusing that reader. See Fix a blank Power BI report in Confluence.


#A few things that catch people out

  • The first click on the report activates it, so the page can still scroll past it.

  • A link copied from the browser address bar while browsing a workspace is not an embed link.

  • The macro is in the separate Power BI for Confluence app, not in the Capable Suite.



One macro, documented properly.