HTML Macro
The HTML macro allows you to add HTML code to a Confluence page.
HTML macros are disabled by default
The HTML macro will only be available if it has been enabled by an administrator. Enabling these macros can make your Confluence site vulnerable to cross-site scripting attacks.
Using the HTML Macro
To add the HTML macro to a page:
- In the Confluence editor, choose Insert > Other Macros
- Find and select the required macro
Speeding up macro entry with autocomplete: Type { and the beginning of the macro name, to see a list of suggested macros. Details are in Autocomplete for links, files, macros and mentions.
To edit an existing macro: Click the macro placeholder and choose Edit. A macro dialog window will open, where you can edit the parameters of the macro.
There are no parameters for this macro.Enter the HTML code into the body of the macro placeholder.
Enabling the HTML Macro
The HTML macro is disabled by default. You'll need Confluence Administrator or System Administrator permissions to enable this macro.
Enabling these macros can make your Confluence site vulnerable to cross-site scripting attacks. You should only turn on these macros if you trust all your users not to attempt to exploit them. We strongly recommend leaving this macro disabled if you allow self-signed up or anonymous users to create content.
To enable the HTML macro:
Go to > Add-ons.
- Select System from the drop down and search for the Confluence HTML Macros add-on.
- Expand the add-on and enable the html (html-xhtml) module.
Code examples
The following examples are provided for advanced users who want to inspect or edit the underlying markup for a Confluence page.
Macro name: html
Macro body: Text, consisting of HTML code.
Parameters: None.
Storage format example
<
ac:structured-macro
ac:name
=
"html"
>
<
ac:plain-text-body
>
<![CDATA[<a href="http://www.atlassian.com">Click here</a> to see the <b>Atlassian</b> website.]]>
</
ac:plain-text-body
>
</
ac:structured-macro
>
Wikimarkup example
{html}Click here to see the Atlassian website.{html}