> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yamuno.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting Started with HTML Macro for Confluence

> Learn how to embed custom HTML, CSS, and JavaScript directly inside Confluence pages

# Getting Started

**HTML Macro for Confluence** lets you embed fully custom HTML, CSS, and JavaScript directly inside any Confluence page — with a live side-by-side editor, enterprise-grade CSP security controls, and granular editor access restrictions. Everything runs on Atlassian Forge; no data leaves Atlassian's infrastructure.

![HTML Macro for Confluence](https://assets.yamuno.com/html-macro/highlight1.png)

## Quick Overview

HTML Macro for Confluence allows you to:

* Write **HTML, CSS, and JavaScript** in a three-tab editor with syntax highlighting
* **Preview your output in real time** in a resizable split panel
* Control which **external domains** can load resources via CSP security modes (Block all / Whitelist / Allow all)
* Restrict **who can open and edit** the HTML editor by user whitelist
* Auto-adjust **iframe height** — no fixed heights, no blank space below content
* Track **which Confluence pages** use the macro via usage analytics

## Documentation Structure

* **[Quick Start Guide](/html-macro-for-confluence/getting-started/quick-start)**: Install the app and embed your first HTML widget in minutes
* **[Features & How To](/html-macro-for-confluence/how-to-and-features)**: Complete guide to the editor, security settings, and access control
* **[Security & CSP](/html-macro-for-confluence/how-to-and-features/security)**: Configure content security policies and domain whitelists
* **[Admin Guide](/html-macro-for-confluence/how-to-and-features/admin-guide)**: Set up access control and usage analytics
* **[Known Issues](/html-macro-for-confluence/known-issues)**: Current limitations and workarounds
* **[Release Notes](/html-macro-for-confluence/release-notes)**: What's new in each version

## Getting Help

* Visit our [support portal](https://yamuno.atlassian.net/servicedesk/customer/portals)
* Email us at [support@yamuno.com](mailto:support@yamuno.com)