Embed/iFrame
Embeds an external web page - a YouTube video, a Figma file, a Google Doc, a Miro board or any approved HTTPS URL - directly inside your Confluence page as a live frame.
Use it when the thing you want on the page lives somewhere else and a link is not enough: a product demo on YouTube, a design in Figma, a live Miro board, a Google Form or a dashboard on an internal tool. You paste the ordinary URL you would send a colleague - the watch URL, the share URL, the file URL - and the macro converts it to the correct embeddable address, picks a sensible shape for that kind of content, and grants that provider the permissions its player needs. It is the general-purpose escape hatch for external content, sitting alongside the more specialised RSS feed, Swagger/OpenAPI and Web Extraction macros. One hard prerequisite: a site admin must have approved the destination domain for the Frames egress type, otherwise Confluence's own security policy blocks the frame and the macro shows a notice instead. The macro is marked Beta, so it carries a Beta badge in the macro catalogue and the command palette.
#See it
Every example below is a real macro on this page, not a screenshot, and each one is a configuration taken from a page somebody actually built. Open this page in the editor to see how any of them is set up.
#Center, full: youtube.com
#Settings
Setting | Values | What it changes |
|---|---|---|
URL | An https:// web address. Anything else (http://, a relative path, malformed text) is rejected. | The page to embed. As you type, the panel tells you three things: whether the URL is embeddable at all ("Only https:// URLs can be embedded."), whether it matched a known provider ("Detected YouTube - auto-embedded."), and whether |
Title | Free text. | The accessible name announced for the frame by screen readers. Left empty, the macro falls back to the host it is embedding (for example "www.youtube.com"), and if even that is unavailable to the literal text "Embedded content". I |
Width | Full width, Fixed width | Full width makes the frame fill the page column. Fixed width reveals a pixel box next to the dropdown and constrains the frame to that width (still capped at 100% of the column, so it never overflows on a narrow screen). |
Width (px) | 100 to 2000 (the number input clamps on blur, stepping by 10) | The pixel width of the frame. Only shown, and only used, when Width is set to Fixed width - at Full width the value is stored but ignored. |
Height | Aspect 16:9, Aspect 4:3, Aspect 1:1, Aspect 21:9, Fixed height | How tall the frame is. The aspect options size the frame from its own width, so it stays correctly proportioned as the page column resizes - right for video and design embeds. Fixed height reveals a pixel box and pins the frame to |
Height (px) | 100 to 2000 (clamped on blur, stepping by 10) | The pixel height of the frame. Only shown, and only used, when Height is set to Fixed height - with any aspect option selected the value is stored but ignored. |
Align | Left, Center, Right | Where the frame sits in the page column. The panel says so explicitly: it is "Alignment when a fixed width is used". At Full width the frame already fills the column, so changing this has no visible effect. |
Allow fullscreen | On / Off | Whether the embedded page may take over the whole screen. For an arbitrary (non-provider) URL this is the switch that grants or withholds fullscreen. For a recognised provider the permission set comes from the provider entry inste |
Corner radius (Style tab, Frame section) | Slider, 0 to 24 px | Rounds the frame's corners and clips the embedded page to that rounding. Any value other than 6 is applied on its own, whether or not the frame has a border or shadow. The value 6 is treated as "leave it as it was" and only produc |
Shadow (Style tab, Frame section) | None, S, M, L (a four-way segmented control) | A resting drop shadow around the frame, lifting the embed off the page. Setting any shadow also counts as "framed", which turns on the default 6px rounding. |
Border (Style tab, Frame section) | On / Off toggle. When on, two further controls appear: Width (slider, 0-6 px) and Color (a brand colour picker for the border role, clearable, with a custom colour option if your brand settings allow one). | Draws a line around the frame. Leaving Color cleared keeps the border on the Confluence theme colour so it adapts to light and dark mode; choosing a colour pins it. Turning the border on also counts as "framed", which turns on the |
#Related
The largest family, and the most precise.
