Iframes for Confluence

Iframes for Confluence is the macro that allows any user to easily embed an iframe into a page. Improve your pages or blog posts with this simple Confluence macro.

How to use Iframes for Confluence:

Here’s how to successfully embed an iframe into your page or post with two easy steps:

  1. Insert the Iframe Macro into your Confluence page
  2. Paste the URL into the macro body (the box in the editor, not in the macro edit view)

If you need to embed custom HTML, we now have a Secure HTML Macro:

  1. Insert the Secure HTML Macro into your Confluence page
  2. Paste your HTML code into the macro body (the box in the editor, not in the macro edit view)

Adjust the size for further customization. Select a size that works best for you, choose from any of the following unit formats:

  • Just the number – 100 (becomes pixels)
  • Number of pixels – 100px
  • Number of ems – 10em
  • Percentage of screen size – 75%

We also now support Iframe Sandboxing with the following parameters:

  • allow-forms
  • allow-pointer-lock
  • allow-popups
  • allow-same-origin
  • allow-scripts
  • allow-top-navigation

These are complex options which you should understand before you enable or disable any of them. Please review the sandbox parammeter at https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe to better understand them.

Administrators can disable sandbox options on a per macro basis.


Q: Is it just not working?

A: Double check that you’re using a secured link which starts with HTTPS. If your resource isn’t served over HTTPS, it can’t be embedded in iFrames for Jira Cloud.

Q: My gadget is blank. Why?

A: Ad blockers are usually the cause. Try to disable any ad blockers you are currently using.

Q: I disabled my ad blockers, but my gadget is still blank. Why?

A: It is likely that the website requested that it not be embedded. If you or your company owns this site, you can fix this.

Q: How can I fix my website that is preventing my gadget from working?

A: Implement an Access Control Allow Origin HTTP header. If you need additional information, please visit the mozilla docs for a more detailed explanation.

Q: I received an error message that says, "Please set a valid width" AND/ OR "Please set a valid height":

A: This means that you have entered an iFrame size in an invalid format. Please see above for instructions on supported formats.

Q: I received an error message that says, "Please provide a valid URL":

A: This means that you have provided a malformed URL. Please note that we only support URLs with the HTTP and HTTPS schemes.

Q: What are some known issues?

A: If your iFrame comes up as an empty white box it may be one of three things.

1. Try and disable any ad-blockers you are using.

2. Check if Confluence is on HTTPS and the remote site is on HTTP. If this is the case, your web browser is blocking the page. You will need to place the remote site behind HTTPS.

3. If the issue persists, this means that the remote website has explicitly requested that it not be embedded into another site. This could be done using a number of headers including Content-Security-Policy and X-Frame-Options. If you or someone in your organization controls the remote website, you can make some tweaks to fix this. Take a look at the mozilla documentation for a detailed explanation.

If your question is not listed, please reach out via our service desk here.