How to Embed Content in Notion (2026 Complete Guide)
Notion supports embeds for over 1,900 services through Iframely, plus dedicated integrations for Figma, Loom, YouTube, Google Drive, GitHub, and a few dozen others. The mechanism is the same in all cases, paste a URL or use the /embed slash command, and Notion renders a live preview inside the page.
Here’s how each method works and what to do when an embed doesn’t render the way you expect.
1. The /embed Slash Command
The universal way to add an embed. Works for any URL Iframely supports.
Add an embed
- Open the page and place your cursor on a new line.
- Type / to open the slash menu.
- Type embed and select Embed from the menu.
- Paste the URL of the content you want to embed.
- Click Embed link.
The embed renders live in the page. You can drag the corners to resize.
Reposition or replace
- Drag the embed by its left handle (⋮⋮) to move it.
- Click the ••• menu on the embed to delete it, replace the URL, or open it in a new tab.
2. Paste-to-Embed (Auto-Recognition)
For services Notion knows about, you can skip the slash command entirely.
How it works
- Copy the URL from the source (e.g., a Figma file URL, a Loom video URL, a YouTube link).
- Paste it onto a Notion page.
- A small popup appears with four options:
- Dismiss: leave the URL as plain text.
- Mention page: only appears if the URL is a Notion page.
- Create bookmark: render a card with title, description, and favicon.
- Create embed: render the content live inline.
- Click Create embed.
For some services (YouTube, Vimeo, Spotify), Notion may embed automatically without showing the popup.
Bookmark vs. embed
- A bookmark shows a static card with the page’s metadata. Good for articles and references.
- An embed shows the live content (the video plays, the Figma file is interactive, the Google Doc shows the latest version). Good for collaborative work.
3. Common Service-Specific Embeds
Notion has dedicated handling for these, they often look better than a generic embed.
Figma
- Type /figma and select Figma.
- Paste a Figma file or frame URL.
- The file renders interactively, you can zoom and pan inside the embed.
Anyone viewing the Notion page needs at least view access to the Figma file.
Loom
- Type /loom and select Loom.
- Paste a Loom share URL.
- The video plays inline.
YouTube and Vimeo
- Type /youtube or /vimeo, or paste the URL directly.
- The video plays in-page with native controls.
Google Drive (Docs, Sheets, Slides)
- Type /google drive and select Google Drive.
- The first time, click Connect Google Drive and authenticate.
- Search by file name or paste the Drive URL.
- Click Embed.
The file appears as a live preview. Edits made in Google Drive are visible in Notion in real time. Viewers need access to the underlying Drive file.
Twitter / X
- Type /tweet or paste the tweet URL.
- The tweet renders with the original formatting, including media and replies.
Miro
- Type /miro and select Miro.
- Paste the board URL.
- The board is interactive inside Notion, pan, zoom, and click into frames.
GitHub Gist
- Type /gist or paste the Gist URL.
- The gist renders with syntax highlighting.
Other supported services
Iframely powers most embeds, so the list is long. Common ones include: CodePen, Replit, Framer, Whimsical, Lucidchart, Excalidraw, Spotify, Apple Music, SoundCloud, Typeform, Tally, Google Maps, Twitch, Deepnote, and Hex.
4. File Embeds (Upload from Computer)
For content that doesn’t live online, upload the file directly.
Upload a file
- Place your cursor on a new line and type /file.
- Select File.
- Click Upload and pick a file.
- The file renders inline if Notion can preview it, PDFs are scrollable, images display as image blocks, videos play in-page, audio shows a player.
File-specific slash commands
- /pdf: embed a PDF with an inline scrollable preview.
- /image: upload an image (or paste an image URL).
- /video: upload a video file or paste a video URL.
- /audio: upload an audio file or paste a streaming URL.
Upload size limits
| Plan | Per-file upload limit |
|---|---|
| Free | 5 MB |
| Plus | Unlimited |
| Business | Unlimited |
| Enterprise | Unlimited |
5. Generic URL Embeds (Anything Else)
If a service isn’t in Notion’s recognized list, you can still try to embed it.
Steps
- Type /embed and select Embed.
- Paste the URL.
- Click Embed link.
If the underlying site allows iframe embedding, it’ll render. If the site blocks iframes (many do for security reasons), Notion shows the URL as a link preview instead.
When an embed doesn’t render
The most common reason: the source site sends an X-Frame-Options: DENY header, which prevents iframe embedding. There’s no workaround in Notion, you’ll need to use a bookmark or static screenshot instead.
Quick Reference
| Method | Best for | How to start |
|---|---|---|
| /embed | Any URL Iframely supports | Type /embed |
| Paste URL | Quick auto-recognized embeds | Paste, then click Create embed |
| Service-specific (e.g., /figma, /loom) | Curated rendering for popular tools | Type /[service name] |
| /file or upload | PDFs, images, audio, video from your computer | Type /file |
| Bookmark | Article references that don’t need live preview | Paste, then click Create bookmark |
Which Method Should You Use?
- Embedding a popular service (Figma, Loom, Google Doc)? Use the service-specific slash command. The result is usually nicer than a generic embed.
- Embedding a less common URL? Use /embed.
- Embedding a local file? Use /file or the file-type-specific commands like /pdf.
- Linking to an article for reference? Use a bookmark: it’s lighter and doesn’t try to load the page in an iframe.
- Embed not rendering? The source site likely blocks iframes. Use a bookmark or screenshot.
Stop Manually Pasting the Same Embeds
If you’re embedding the same dashboards, docs, or reports into every project page, that work can be automated. Carly is an AI assistant that connects to 200+ apps including Notion and handles the repetitive work for you.
More on Notion: How to create a database in Notion · How to link pages in Notion · How to add a template to Notion · How to share a page in Notion
Ready to automate your busywork?
Carly schedules, researches, and briefs you—so you can focus on what matters.
Get Carly Today →Or try our Free Group Scheduling Tool or Free Booking Page