Paste-to-embed (auto-convert)

Confluence hands the link over separately from the macro configuration, so the macro reads it, saves it into its own config once, and renders. Nothing is written to config until that first save completes.


#How

Paste a link starting https://app.powerbi.com/ or https://app.fabric.microsoft.com/ into the Confluence editor and the Power BI macro is inserted around it automatically.


#Where you do it

Task

Where

Add a Power BI report to a page

-

Add a report by pasting a link

-

Get the right link out of Power BI

-


#Settings that affect this

Setting

Where

What it does

Migration tab

Global settings

-


#Limits that apply here

Limit

Value

What happens

Allowed URL shapes

Exactly one path segment: /view or /repo

/view must carry an 'r' query parameter (secure report link). /reportEmbed must carry a 'reportId' query parameter (public report link). Anything deeper or differently shaped fails validation.

Bare report ID format

A standard 36-character UUID

A UUID is turned into https://app.powerbi.com/reportEmbed?reportId=<id>&autoAuth=true. It always targets app.powerbi.com, never Fabric.

Stored data

None

No credentials, no tokens, no cached report content. The embed address lives in the page itself.


#Worth knowing

  • Auto-convert on paste stores nothing in the macro configuration at first; the macro has to write the link into its own config on first render. Until that happens the configuration panel looks empty.

  • The macro does not set an iframe sandbox attribute, so the embedded Power BI page runs with the normal permissions of a cross-origin frame.



Better with company.