How to embed an iframe in Notion
Notion has an Embed block. You paste a URL that starts with https, not iframe code, and Notion builds the frame. The page you embed must allow other sites to frame it, or Notion shows a "Failed to Load" error.
3 min read · Updated
- Raw iframe code
- No
- Embed block
- Yes
- Needs
- A URL that allows framing
Steps
Step 1: Click + and choose Embed
Hover over a new line and click the + on the left. Choose Embed and press Enter. You can also type /embed.
Step 2: Paste the URL in the menu
Use the URL that starts with https, not the iframe code. Notion builds the frame from the link.
Step 3: Drag the black bars to resize
Hover over the embed and drag the black bars on the sides. Use the ⋮⋮ handle to move the embed or to put it in a column.
Step 4: Use Replace to change the link
Hover over the embed and click ••• at the top right. Choose Replace, then Embed link, and paste the new URL.
Check your URL first
If the page blocks framing, the Embed block shows an empty box or an error.
Limits
The Embed block takes a URL. You cannot paste iframe code.
Embeds that need a login to an external site do not work in the Notion desktop app or mobile apps.
Notion uses the Iframely service for embeds, so Iframely and the embedded app can get the IP address of viewers.
Troubleshooting
- "Failed to Load" error
The site does not allow other sites to frame it. It sends X-Frame-Options or a CSP frame-ancestors rule. Only the site owner can change that.
Why a site refuses to load in a frame- The block is blank
Test the URL to find the header that blocks the frame. Open the URL in a new tab to make sure the page loads.
Blank iframe, no error- Signed out in the frame
Embeds that need a login do not work in the Notion desktop or mobile apps. In a browser, third-party cookie blocks can also stop the login.
Login doesn't stick