Configuration Overview
HTML Macro for Confluence has a global settings panel accessible to Confluence site administrators. Settings apply across all HTML macros on your entire Confluence site.
- Go to Confluence Administration
- Click Manage Apps
- Find HTML Macro for Confluence
- Click Configure
The settings panel has three tabs: Security, Permissions, and Usage.
Control how external content is handled inside HTML macros:
- External Content Security — choose between Block all, Whitelist only, or Allow all
- Domain Whitelist — manage which external domains are permitted
- Allowed Protocols — specify which URL protocols are allowed (e.g.
https, mailto, tel)
- Content Size Limit — set the maximum allowed macro size in KB
Configure Security Settings →
Control who can access the HTML editor:
- Restrict editor access — limit the editor to a specific list of users
- Allowed Users — manage the user whitelist
Configure Permissions →
View all Confluence pages that contain an HTML Macro:
- Stats overview — total pages, published pages, and number of spaces using the macro
- Sortable table — columns for page title, excerpt, space, status, and last modified date
- Search & filter — instantly find any page across all columns
- Direct links — open any page in Confluence with one click
After making changes in either tab, click Save Changes at the bottom of the page. An unsaved indicator (amber dot) appears in the footer whenever there are pending changes.
Changes take effect immediately — no app restart or page reload is required.
