The iFrame macro lets you embed a webpage inside a Confluence page.
Use the iFrame macro
To add the iFrame macro:
- In the Confluence editor, select
> View more - Find the item to be inserted and select it
- Select Insert
You can also type / onto the page to bring up the same list you'd see by selecting from the toolbar.
To add the iFrame macro:
- Select the macro placeholder. The floating toolbar appears.
- Select Edit. The right panel opens.
- Modify the parameters. Your changes are saved as you go.
- Resume editing the page, and the panel closes.
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.