Broken Macro Fixer for Confluence — Documentation

Find every broken macro on your Confluence Cloud site and fix it in bulk, with a preview first and undo through page history.

Who can use it

Confluence site admins. The app lives in Confluence administration: open Settings (the gear icon), then choose Broken Macro Fixer in the sidebar.

Run your first scan

Open Broken Macro Fixer and click Start scan.
The scan runs in the background across every page in every space the app can read. You can leave the page; progress is saved, and large sites are scanned in batches.
When it finishes you'll see a summary, such as "Broken macros: 37 on 21 pages", and a table of macros by name.

What the statuses mean

Broken: Confluence can't display this macro. The app checks by rendering the page, not by guessing from the name.
Renders: the macro displays normally. No action needed.
Not checked: the scan hasn't rendered this macro yet.
Couldn't verify: the app wasn't able to render the page reliably (for example, a page type it can't render). These are never fixed automatically.

Each macro is also labelled as built-in, from an app (with the app name for well-known apps such as draw.io, Gliffy, PlantUML and Mermaid), or Data Center only.

Fix broken macros

In the results, choose a fix for each broken macro you want to clean up: Replace with a note or Remove completely. You can apply a fix across all pages or to single pages.
Click Preview. Nothing is changed yet. The preview lists every page that would change and exactly what would happen.
Click Confirm to apply. Each page shows its result and its old and new version numbers.

"Replace with a note" puts a short panel where the macro was, saying the original is in page history. "Remove completely" deletes the macro from the page.

Safety rules

Nothing is changed until an admin previews a fix and clicks Confirm.
Pages edited after the scan are skipped, so recent work is never overwritten. Rescan to include them.
Pages with edit restrictions the app can't edit are reported as blocked and left alone.
Pages are never deleted.

Undo a change

Open the change log in Broken Macro Fixer and click the page's history link (or open the page and choose Page history).
Find the version just before the Broken Macro Fixer edit and click Restore.

Every fix is saved as a normal page version, so restoring works like any other Confluence edit.

Weekly rescans

Turn on weekly rescans in the app's settings. When new broken macros appear (for example, after another app is uninstalled), a banner shows how many were found since the last scan. Rescans only read pages and never change them.

Data and privacy

The app runs entirely on Atlassian (Forge), sends no data outside Atlassian, and stores no personal data. See the privacy policy.

Support

Email support@frontrangeapps.com. We aim to reply within one business day.