iFrame Macro

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

Using the iFrame macro

To add the iframe macro to a page you're editing:

  1. Tap + > Other macros or type ⌘ + ⇧ + A to open the macro browser.
  2. Type "iframe" in the search box, then select the macro from the results.
  3. Enter the URL of the website you'd like to embed, then tap Save.

Customizing iFrames

You can customize the iFrame macro in several ways:

Attribute Value Description

Height

pixels

Set a fixed height and width for your iframe.

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

Width pixels
Align

left

right

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

Set to left by default.

frameborder

show

hide

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

Set to show by default.

scrolling

yes

no

auto

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.
Last modified on May 3, 2018

Was this helpful?

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