• Products
  • Documentation
  • Resources

Insert the iFrame macro




The iFrame macro lets you embed a webpage inside a Confluence page.

Use the iFrame macro

To add the iFrame macro:

  1. When editing, select from the toolbar

  2. Find the macro by name and select it

  3. Configure it as needed

You can also type / on the page to bring up the same list you'd see by selecting from the toolbar. Continue typing the name of the macro to filter the list.

To edit the iFrame macro:

  1. Select the macro placeholder.

  2. Select the Edit icon to open the configuration panel.

  3. Configure the parameters. Your changes are saved as you go.

  4. Resume editing the page, and the panel closes.

You can also select the centered , medium-width , and full-width icons to adjust the width of some macros. Select the trashcan iconto remove the macro.

Customizing iFrames

Parameters are options that you can set to control what and how content from the macro appears on the page. 

If the parameter name used in Confluence Cloud storage format or wikimarkup is different than the label used when inserting macros using the browser or the slash command, it will be listed below in brackets (example).






Set a fixed height and width for your iframe.

This is especially helpful for content that won't display properly below a certain size.






Align the iframe to the left or right of the page.

Set to left by default.




Draw a border around content in the iframe to help distinguish it from other content on the page.

Set to show by default.





Allow or prevent scrolling in the iFrame to see additional content.

Set to auto by default.

The remaining attributes (ID, class, styles, title, long description, margin height, margin width, name, text direction, and language code) are being deprecated. Changing the values of these attributes won't affect how content in the iFrame macro appears.

Known issues

Some websites may show up as blank when you try to include them as part of an iFrame. This could be because:

  • The website administrators have invoked the x-frame-options response header to prevent browsers from rendering it in an iFrame.

  • The browser you're using has blocked the website from loading as a security precaution.

If the website you're trying to include isn't showing up in the iFrame, try:

  • Replacing http:// with https:// at the start of the URL to access content more securely.

  • Removing the iFrame macro and adding a link to the website instead.


Still need help?

The Atlassian Community is here for you.