Remove Macro in Bulk
The Remove Macro in Bulk feature allows Confluence administrators to remove a specific macro from multiple pages at once. This is ideal for clern up the old/useless macros from many pages.
1. Configure Scan Conditions
1.1. Select Scan Mode
Choose how the pages should be scanned. Note that some native macros (e.g., info, warning) are not searchable via Atlassian’s Search REST API, so they require full-page scanning.
Scan Mode | Description |
|---|---|
Search pages | Scans only pages that contain specified macros. Fast, but not compatible with certain native macros. |
Scan all pages | Scans all pages in the selected spaces. Required for macros like |
1.2. Define Macro Settings
Specify the macro to insert, along with its parameters and position.
Field | Description |
|---|---|
Macro name | Use the macro name as it appears in the storage format. You can find this via More → Advanced Details → View Storage Format on a Confluence page. |
Keep macro content | Control whether the rich text body inside the macro is preserved when removing macros. |
1.3. Define Target Scope
Choose which pages to include in the scan.
Field | Description |
|---|---|
Target spaces | The Confluence spaces where the macro will be added. |
Content type | Choose to scan pages, blog posts, or both. |
Filter by labels | (Optional) Include only pages with any of the selected labels. |
2. Run Bulk Operation
2.1. Preview Scan Results
Click Start Scan to preview the list of pages that match your criteria.
2.2. Start Task
Click Remove Macros to run the bulk operation. A background task will be created—you may stay on the page or leave safely while it runs.
3. Best Practices & Tips
Always test in a staging or test space before applying changes to production spaces.
Use Scan All Pages mode when inserting native macros like
infoorwarningwhich cannot be found via the Search API.You can find macro name and parameters from storage view of the page via More → Advanced Details → View Storage Format on a Confluence page.