Skip to main content
Confluence Cloud app

Run a real HTML app on a Confluence page

Upload a folder of HTML, CSS and JavaScript. Mini Sites runs it live and interactive on the page — a clickable prototype, a calculator, an explorable diagram. Not a screenshot, not a link. The actual thing.

yourteam.atlassian.net/wiki/spaces/Product/pages/new-onboarding-feature-review
CConfluenceProduct / New Onboarding — Feature ReviewP

New Onboarding — Feature Review

Edited by Priya · just now
▦ Mini-Site macro

The problem it solves

A prototype that only runs on your laptop cannot be reviewed by the people who decide on it. The usual workarounds all lose something.

Screenshots

The interaction is gone; reviewers argue about what a click would have done.

A link to a dev server or hosting service

One more system to keep alive, one more access list to manage, and it breaks the moment the laptop sleeps.

A pasted HTML snippet

Fine for a badge or an embed code, not for a multi-file app with its own CSS, JavaScript and assets.

Mini Sites removes the hosting step entirely: the folder you already have goes onto the page where the decision is being made. If what you have is a CI build, a docs export, or an AI-generated bundle rather than a hand-built prototype, see publishing a generated site to a live Confluence page for that specific flow.

How it works

1
Edit

Insert the Mini-Site macro on any Confluence page (type /Mini-Site).

2
Upload

Choose the folder that contains your index.html — nested folders and relative paths resolve exactly as you built them.

3
Publish

The bundle is validated and secret-scanned, then renders inline. Anyone who can view the page can use it.

What you can put on a page

Clickable prototypes

The UI you are asking the team to approve, running, on the page with the PRD.

Filterable dashboards

A chart and a set of filters over a JSON file you ship in the bundle.

Small internal tools

A pricing calculator, a checklist generator, a troubleshooting decision tree.

Design system demos

Components rendered from the same CSS the app ships.

Permissions and security

  • Confluence permissions are inherited. The app is built on Atlassian Forge; access follows the page. There is no second sharing model to keep in sync.
  • The app requests no Confluence API scopes. It does not read your page content.
  • Each macro instance runs in its own isolated, non-routable sandbox — there is no public URL to leak.
  • Every bundle is validated and secret-scanned before it is served: an index.html at the root, relative paths only, no ../ traversal, and a scan for AWS/GCP keys and tokens.

Limits

LimitValue
Files per bundle2,000
Maximum file size25 MiB
Maximum bundle size50 MiB
Required fileindex.html at the folder root

The sandbox is static-only and has no outbound network access — external fonts, CDNs and API calls are not available, so bundle the assets you need. That constraint is deliberate: it is what makes the mini site safe to run inside your wiki.

Questions people ask