• 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 item to be inserted and select it

  3. Select Insert

You can also type / on the page to bring up the same list you'd see by selecting from the toolbar.

To edit the iFrame macro:

  1. Select the macro placeholder. The floating toolbar appears.

  2. Select Edit. The right panel opens.

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

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

Customizing iFrames

Parameters are options that you can set to control the content or format of the macro output. 

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.


Additional Help