Documentation
HTML Macro+ for ConfluenceBrowse
Documentation
HTML Macro+ for ConfluenceFeatures overview
HTML Macro+ for Confluence is a full-featured code editor and renderer built directly into Confluence. Here's what's included.
HTML, CSS & JavaScript editor
A three-tab code editor lets you write HTML, CSS, and JavaScript separately. The header has buttons for the library and a More menu with Save as component, Embed templates, Copy AI prompt, Documentation and Support. Each tab has syntax highlighting, auto-complete, and configurable editor settings (font size, tab width, theme).
Shared library: variables, components and brand
Admins keep shared building blocks in the app's settings, and every macro on the site can use them:
- Variables such as
{{companyName}}, plus built-ins for today's date, the page title and the space key - Components such as
<ReleaseBanner />, with settings, drafts, publishing and version history - Brand colours, fonts, images and design tokens, used as CSS custom properties such as
var(--brand-primary)
The editor header has Variables and Components buttons to insert them at the cursor.
Live preview
A resizable split-panel preview updates as you type. The preview runs your actual HTML/CSS/JS in a sandboxed iframe, so what you see is exactly what Confluence visitors will see.
Secure content rendering
When your page is viewed, the HTML renders inside an isolated iframe with Content Security Policy (CSP) enforcement. External resources are controlled by your admin's security settings: block all, whitelist specific domains, or allow all.
Dark mode
Macros know whether Confluence is in light or dark mode, so your CSS can match the page instead of staying white. It switches as soon as the viewer changes theme.
Embed templates
Embed YouTube, Vimeo, Loom, Figma, Miro, Google Docs and Sheets, Power BI, Tableau and more by pasting a link. The macro writes responsive iframe code for you, which you can still edit.
Link & navigation handling
All anchor links and window.open() calls inside your HTML are automatically handled through Confluence's routing system. Links work as expected: internal Confluence links navigate within Confluence, external links open safely.
Content size limits
Admins can set a maximum content size limit (in KB) to prevent oversized macros from impacting page load performance.
Version history & collaboration
The last 10 saved versions of every macro, with who saved each one and a one-click restore. The editor also shows who else has the same macro open and tells you when they save.
HTML from Attachment
A second macro that renders a complete .html file you upload, styles included, ideal for exported reports and generated dashboards.
Server/Data Center macros
Pages migrated from Server or Data Center render their old HTML, Macro Toolbox HTML and HTML Include macros instead of showing an error. Hover one to migrate it into an editable macro.
Access permissions
Restrict who can open and edit the HTML editor to specific users and Confluence groups. Everyone else can still view the rendered output.
Macro usage analytics
The Usage tab in the admin settings panel shows you every Confluence page that contains an HTML Macro. At a glance you get total page count, published page count, and number of spaces using the macro. The sortable, filterable table lets you find any page instantly, and a direct link opens each page in Confluence.
Migration from other apps
Bulk-migrate HTML macros from other apps (Appfire, Narva, Macro Toolbox) and legacy Server/DC macros into HTML Macro+, a space at a time, with a dry-run preview.
Guides for HTML Macro+ for Confluence
Stuck on something this page does not cover? Ask the developers.