HTML Include Macro

Add the HTML Include macro to a page to include the contents of specific URL in a Confluence page.  This allows you to embed a webpage in your Confluence page. 

This is a legacy macro, and is often disabled by Confluence administrators for security reasons.

On this page:

Security considerations

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.

Add this macro to your page

To add the HTML Include macro to a page:

  1. From the editor toolbar, choose Insert > Other Macros.
  2. Choose HTML Include from the External content category.
  3. Enter the URL you want to display.
  4. Choose Insert

You can then publish your page to see the macro in action. 

Change the macro parameters

Macro parameters are used to change the behaviour of a macro.

To change the macro parameters:

  1. In the editor, click the macro placeholder and choose Edit.
  2. Update the parameters as required then choose Insert.

Here's a list of the parameters available in this macro. 

ParameterRequiredDefaultDescription
HTML Page's URL
(url
YesNoneThe URL of the page to include.

Where the parameter name used in Confluence storage format or wikimarkup is different to the label used in the macro browser, it will be listed below in brackets (example).

Enabling the HTML Include Macro

The HTML Include macro is disabled by default. You'll need Confluence Administrator or System Administrator permissions to enable this macro.

(warning) 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 Include macro:

  1. Go to Administration > Manage apps

  2. Select System from the drop down and search for the Confluence HTML Macros system app.
  3. Expand the listing and enable the html-include (html-include-xhtml) module.

Administrators can also choose to use the allowlist to restrict URLs that can be displayed in the HTML Include macro.

Troubleshooting

  • Administrators can define an allowlist of trusted URLs. If a URL is not in the allowlist, you will see an error message in the HTML Include macro.
  • 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, you will see a 'Page Not Found' error. See CONF-6567 - Getting issue details... STATUS .

Other ways to add this macro

Add this macro as you type

Type followed by the start of the macro name, to see a list of macros. 

Add this macro using wiki markup

This is useful when you want to add a macro outside the editor, for example as custom content in the sidebar, header or footer of a space.

Macro name: html-include

Macro body: None.

{html-include:url=http://www.example.com}
Last modified on Jul 29, 2022

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.