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:
- Tap + > Other macros or type ⌘ + ⇧ + A to open the macro browser.
- Type "iframe" in the search box, then select the macro from the results.
- 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.