Macro shows an empty box - no board appears
What you are seeing
The macro shows an empty box - no board appears.
#Why it happens
The Board URL is not a miro.com address. Confluence only permits framing miro.com, so anything else is blocked silently rather than reported as an error.
#What to do
Open the macro configuration and replace the URL with a real Miro link (https://miro.com/app/board/..., /app/embed/... Or /app/live-embed/...).
#Settings involved
Setting | Where | What it does |
|---|---|---|
Miro (Confluence settings entry) | - | Opens the app's admin page, which shows only an Introduction section. There are no Miro-specific admin settings. |
Connect Miro | - | Starts the Miro authorisation in a new browser tab (OAuth providers block sign-in inside an iframe). The app then polls its own status every 2.5 seconds while the consent tab is open, and re-checks whenever you return to |
Board URL, Display mode, Width, Height | - | The only per-instance options; see the macro parameter list. |
#Limits that apply here
Limit | Value | What happens |
|---|---|---|
Space usage scan | At most 250 pages scanned (25 per reques | - |
#A few things that catch people out
Because the app ships permission changes pending approval, a newly added permission degrades the feature that needs it until an admin approves it in Admin Hub. In practice this shows up as "Page usage unavailable ... A site admin can approve it in Admin Hub." on the gallery.
A dead or revoked Miro token is reported as "Your Miro connection has expired" and treated as not connected, so the app offers Connect. A network or infrastructure failure is kept separate and shows "Miro status unavailable" - the app will not claim you are disconnected unless it knows.
Never remove or rename a stored macro parameter: unknown keys are stripped on save, so an undeclared parameter would be silently deleted from customer pages. Every field tolerates unexpected values so a legacy macro degrades to a working board rather than a blank one.
#Related
Space boards tab is missing boards, or the "on N pages" count looks too low
The scan is capped at 250 pages and 1000 macro instances per space.
Board I just created in Miro does not show in the picker
Miro takes a few seconds to index newly created boards.
Something is missing or looks wrong
The rest of this family.
Found it? Good.
