The HTML Include macro allows you to include the contents of an external HTML file in a Confluence page.
Using the HTML Include Macro
To insert the HTML Include macro into 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 Using Autocomplete.
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.
The information on this page does not apply to Confluence OnDemand.
Parameters
Parameters are options that you can set to control the content or format of the macro output.
Parameter | Default | Description |
---|---|---|
HTML Page's URL | None | The URL of the page to include. |
Troubleshooting
- The HTML Include macro will only be available if it has been enabled by your Confluence administrator. Also, your Confluence Administrator can define a whitelist of trusted URLs. You will see an error message on the Confluence page if the included URL is not in the whitelist.
- You can only use the HTML Include macro for pages with absolute links. If you use the macro to include an HTML page that has relative links, navigating those links in the wiki results in a 'Page Not Found' error. See CONF-6567.
Code examples
See: