Installation guide

Install HTML Macro+ for Confluence on your Atlassian Confluence Cloud instance.

Requirements

Platform: Confluence Cloud only (not Server or Data Center)
Role: Confluence site administrator
Runtime: Atlassian Forge, no external servers required, runs entirely on Atlassian infrastructure

Install from the Atlassian Marketplace

Go to Atlassian Marketplace and search for "HTML Macro+ for Confluence"
Click "Get it now"
Select your Confluence site from the dropdown
Follow the installation prompts
Installation completes in 1–3 minutes

HTML Macro+ is free for sites with up to 10 users. Larger sites take a monthly or annual subscription through Atlassian, and the Marketplace offers its usual free 1-month trial first. See Licensing.

Once installed, the HTML macro is immediately available to all Confluence users with page edit permissions.

Verify the installation

Open any Confluence page in edit mode
Type /html. If HTML Macro+ for Confluence appears in the dropdown, the installation was successful
Click the macro to open the editor

Post-installation configuration (optional)

After installing, site administrators can configure security and permissions:

Go to Confluence Administration → Manage Apps
Find HTML Macro+ for Confluence and click Configure
Adjust security settings (CSP enforcement, domain whitelist) and user permissions, and set up the library of shared variables, components and brand settings

See Security Settings and Permissions for details.

App permissions

When you install or update the app, Atlassian asks a site administrator to approve the permissions it uses. Version 1.2.0 added four, in two pairs:

Read Confluence groups and read users, for group-based editor permissions
Read pages and read blog posts, to migrate legacy and third-party macros

Until the update is approved, the app keeps working, and only those two features wait. Approve it under Settings → Apps → Manage apps.

Who can do what

Editors (users with page edit permission) can create and edit HTML macros
Viewers see the rendered HTML output only. They never see the source code
Admins have full access to the editor and the global configuration panel, and are the only people who can change the library

Uninstalling

Go to Confluence Administration → Manage Apps
Find HTML Macro+ for Confluence and click Uninstall

Note: Uninstalling removes the app. Existing macros on pages will no longer render and will appear as empty placeholders. Export or copy any important HTML content before uninstalling.