Introducing HTML by Mosaic, for Confluence 📟

[#1]

As Confluence continues to evolve with support for more dynamic content, databases, and AI-powered content creation, many teams are extending its role beyond a collaborative workspace.

Confluence can now power complex intranets, company portals, or knowledge management systems. But these use cases often require going beyond native capabilities. It's common for organisations to install many third-party apps to gain deeper control over their Confluence design elements, structures, and behaviours, which is essential for applying corporate branding, building website-like experiences, or embedding external tools.

The good news is you can achieve that with a single solution. Introducing HTML by Mosaic (from the creator of Mosaic for Confluence)

This app is especially requested by many Confluence Data Center (DC) users migrating to Cloud. They're already familiar with the powerful HTML macro – native to DC – for building custom content elements, rich visuals, and even lightweight applications directly inside Confluence.

What can you do with HTML in Confluence Cloud?

At its core, the HTML macro lets you render custom HTML in a secure iframe, unlocking a wide range of use cases beyond native capabilities. Here are just a few ideas to get you started:

1. Embed external content flexibly

Bring external tools directly into Confluence pages with much greater design flexibility than standard iframes or smartlinks.

• Interactive dashboards (such as BI tools)
• Embedded apps or widgets (including Calendly and media players)

2. Create dynamic and interactive experiences

Move beyond static pages with:

• Custom UI components
• Interactive forms or calculators
• Dynamic content with special visual effects

3. Fully customise your content

Use HTML and CSS to control exactly how your content looks and behaves:

• Advanced layouts and background colors
• Custom styling aligned with your brand guidelines
• Rich formatting for complex documentation

Want to explore real-life use cases? Check out our example pages.

Built with security and control in mind

Running custom HTML/CSS and JavaScript in Confluence naturally raises security considerations, especially in Cloud.

HTML by Mosaic is hosted on Atlassian's own infrastructure (Forge), which means no data leaves your Confluence site. The user's code input is rendered within a sandboxed environment, with safeguards in place to limit unsafe behaviours.

Confluence admins or your IT teams can ensure the macro is used with strict boundaries:

• No access to sensitive Confluence data
• Controlled JavaScript permission (only the site admin can enable this feature)
• Automatic code sanitisation to remove harmful elements, preventing risks of unsafe code injection

In addition, the app is designed with separate HTML/CSS/JavaScript tabs (which means isolating structure, styling, and behaviour implementation). This approach allows different validation and restriction rules to be applied at each layer.

Standard vs Advanced Edition

To support different levels of flexibility and governance, HTML by Mosaic is available as two app editions:

Standard Edition includes sanitised HTML/CSS, the ability to import code from attachments (great for DC users migrating to Cloud), and a code snippets library to get started quickly.

Advanced Edition includes everything above, plus JavaScript support, enabling dynamic logic and interactivity on your pages. As with HTML and CSS, this JavaScript is sanitised and fully secure.

Try Mosaic HTML for Confluence free today 

Looking for HTML customisation and beyond?

Not everyone in your company will feel comfortable creating pages with HTML. To give your less technical users the tools for quick and straightforward page design, you can get the HTML macro alongside visual macros (like Tabs, Buttons, and Advanced Cards), full-page templates, and more with Mosaic for Confluence.

Try Mosaic for Confluence free today