Skip to content
Yamuno
Browse

Release notes


v7.0

Library: variables, components and brand

A new shared library in the app's settings, under Library. Only Confluence admins can change it. See Library.

  • Variables: named values such as {{companyName}} for HTML and CSS, read in JavaScript from window.HTMLMacro.vars. Built-ins for {{today}}, {{page.title}} and {{space.key}}. Values are escaped, and placeholders the library doesn't know are left as written. See Variables.
  • Components: reusable HTML, CSS and JavaScript used as tags such as <ReleaseBanner />, with settings, drafts, publishing, version history and nesting up to 3 levels. Starters for a page footer, document control, status notice, release banner, contact card, project status, FAQ and project roadmap, and Set up a starter kit to create them in one go. See Components.
  • Brand: colours, fonts, shape and logo, and your own tokens as CSS custom properties such as var(--brand-primary), each with an optional dark mode value. Google Fonts, token import and Copy as CSS. See Brand.
  • Brand images: upload PNG, JPEG, WebP, GIF or SVG files and use them as {{brand.logo}}.
  • Groups sort variables and components into sections in the settings and the editor menus.

Editor

  • New Variables and Components buttons in the header. The Variables menu inserts a variable, built-in or brand value at the cursor; the Components picker shows a live preview and inserts the tag with its settings.
  • Typing < in the HTML tab suggests component tags.
  • A new More menu holds Save as component (admins only), Embed templates, Copy AI prompt, Documentation and Support. See HTML Editor.

Licensing

  • HTML Macro+ is now a paid app for sites with more than 10 users, with a monthly or annual subscription through Atlassian and a free 1-month trial through the Atlassian Marketplace. It stays free for sites with up to 10 users. See Licensing for prices. Pages always keep showing their content; editing and the app's settings need a subscription or trial.
  • Launch offer until 28 February 2027: 25% off monthly and annual subscriptions. Request the code. See Licensing.

v6.6

PDF and Word export

  • Macros no longer disappear when a page is exported to PDF or Word. Each one is replaced by an info panel saying the interactive content is on the page.
  • Legacy HTML Include macros also show the address of the included page.
  • No new permissions.

Build with AI

  • New Copy AI prompt button in the editor header copies a prompt for ChatGPT, Claude or any AI assistant you use. It explains how the macro works, includes safety rules and your site's security settings, and can ask for dark mode support. See Build it with AI.

Dark mode

  • Macros can follow Confluence's light or dark theme: style [data-theme="dark"] in your CSS and it switches without a reload, on the page and in the live preview. See Supporting Dark Mode.

v6.0

Version history and collaboration

  • The last 10 saved versions of each macro, with who saved them, a preview and restore
  • See who else has the same macro open and load their saved version in one click

See version history.

Permissions and security

  • Editor permissions now work with Confluence groups as well as individual users
  • Changes to security settings apply to macros that are already open

Before you update

  • This release asks a Confluence admin to approve new read permissions (groups and users, pages and blog posts).

v2.0

First release on the Atlassian Marketplace. Read the launch post.

  • HTML, CSS and JavaScript editor with a live preview
  • Content Security Policy controls for the whole site: Block all, Whitelist only or Allow all
  • Editor access control for chosen users
  • Usage overview of every page that contains the macro

Compatibility: Confluence Cloud

Guides for HTML Macro+ for Confluence

Stuck on something this page does not cover? Ask the developers.