# 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.

---

## Related

[iframe snippet pasteAnother connection.](https://help.gocapable.com/power-bi/iframe-snippet-paste.html)

[Legacy Connect macrosAnother connection.](https://help.gocapable.com/power-bi/legacy-connect-macros.html)

[IntegrationsEvery connection.](https://help.gocapable.com/power-bi/integrations.html)

---

_Better with company._