How to Embed a Widget in Notion
Notion supports URL embeds for 1,900+ domains natively through its Iframely integration. Embeddy widget URLs work out of the box — no plugins, no code, no workarounds. Just paste your widget's Embed Link and Notion renders it inline on your page.
On this page
Prerequisites
Before embedding, make sure you have the following ready:
- An Embeddy widget: Create one for free at embeddy.ai/dashboard. Your widget must be published (not in draft mode) so it is publicly accessible.
- Your Embed Link: In the Embeddy dashboard, open your widget and copy the Embed Link — the direct URL that looks like
https://embeddy.ai/webhost/WIDGET_ID?widget_props_id=PROPS_ID. Do not copy the full iframe code for Notion — Notion only accepts URLs in its Embed block. - A Notion page: Any Notion plan works — Free, Plus, Business, or Enterprise. Embeds are supported in all plans.
Where is my Embed Link? In the Embeddy dashboard, select your widget, click the Share / Embed panel, and look for the Embed Link option. It is the direct URL — not the <iframe> snippet.
Method 1: Embed Block via /embed
Recommended — most reliable method
The Embed block is the dedicated Notion block for displaying external content inline. It uses Iframely under the hood to resolve and render URLs — including Embeddy widget URLs.
- 1
Open your Notion page
Navigate to the Notion page where you want to display the widget. Click anywhere in the body to place your cursor.
- 2
Type
/embedA command menu will appear. Select Embed from the list. You can also click the (+) button in the left margin and choose Embed from there.
- 3
Paste your Embeddy widget URL
An input field appears asking for a URL. Paste your Embed Link:
https://embeddy.ai/webhost/WIDGET_ID?widget_props_id=PROPS_ID
- 4
Click "Embed Link"
Notion will show three options: Embed Link, Create Bookmark, and Dismiss. Click Embed Link. Notion will render your widget inline within a few seconds.
- 5
Confirm it renders correctly
Your widget should appear live and interactive directly within the Notion page. If you see a loading spinner briefly, that is normal — Notion is fetching the embed.
Tip: You can move the Embed block just like any other Notion block — hover over it and use the six-dot drag handle on the left to reorder or move it to another column or section.
Method 2: Paste URL Directly
Quick alternative — works the same way
If you prefer not to use the slash command, you can paste the URL directly into the page body. Notion will detect it and prompt you to choose how to display it.
- 1
Click on an empty line in your Notion page
Place your cursor on a blank line where you want the widget to appear.
- 2
Paste the widget URL
Paste your Embeddy Embed Link on its own line and press Enter. Notion will display a context menu with three choices:
- →Embed — renders the widget inline (choose this)
- →Bookmark — creates a visual link card (not interactive)
- →Mention — inserts a text mention (not an embed)
- 3
Select "Embed"
Choose Embed from the prompt. Notion will load your widget exactly as it would with Method 1.
Note: If you accidentally choose Bookmark, you can convert it. Click the block, open the block options menu (•••), and look for a Turn into Embed option. If that is not available, delete the bookmark and re-paste the URL, this time choosing Embed.
Resizing the Widget
After your widget is embedded, Notion provides visual handles to resize it. No code editing required.
Adjust Width
Hover over the embedded widget. Black side bars appear on the left and right edges. Drag either bar inward or outward to resize the width. The widget content will reflow to fit.
Adjust Height
A resize handle appears on the bottom edge of the embed block. Drag it up or down to set the visible height. Note that Notion enforces a maximum height — see Limitations below.
Moving the block: Hover over the embed to reveal the six-dot drag handle on the left. Use it to drag the embed to a different position on the page, into a column, or under a toggle block.
Limitations
Notion embeds are powerful but have a few platform-level constraints to be aware of:
Maximum height
Notion imposes a maximum height on embed blocks. Very tall widgets may be clipped — users can scroll within the embed frame, but they cannot make it taller than Notion's cap. For very tall content, consider linking to the widget's Embed Link as a regular hyperlink so visitors open it full-screen.
Login-required content in desktop and mobile apps
If your Embeddy widget requires users to be signed in to Embeddy to view it, the embed will not work in Notion's desktop or mobile apps (the apps cannot pass authentication cookies to the embedded frame). It may work in the Notion web app depending on the browser's cookie handling. Solution: make sure your widget is set to public(no login required to view) in the Embeddy dashboard.
Some sites actively block embedding
Some websites set HTTP headers that prevent them from being framed by other sites. Embeddy's webhost URLs do not block embedding, so this limitation does not apply to Embeddy widgets — but it is worth knowing why you might see "Failed to Load" errors with other URLs in Notion.
Notion shared pages
Embeds are visible to anyone who has access to the Notion page. If you share the Notion page publicly, the embedded widget will also be publicly visible. Make sure your widget's content is appropriate for your Notion page's audience.
Troubleshooting
"Failed to Load" or blank embed
This is the most common issue. It almost always means one of the following:
- The widget requires login to view. Go to Embeddy dashboard, open the widget settings, and set visibility to Public.
- The widget is in draft mode. Publish the widget first — only published widgets are accessible at the embed URL.
- The URL is incorrect or outdated. Go back to the Embeddy dashboard and copy the Embed Link fresh.
Notion chose "Bookmark" instead of "Embed"
When pasting a URL, Notion sometimes defaults to creating a Bookmark card instead of an embed. If this happens, delete the bookmark block, then use Method 1: type /embed first, and paste the URL into the Embed block's input field.
Embed does not appear in Notion desktop or mobile app
Some embeds that work in the Notion web app may not render in the Notion desktop or mobile apps due to app-level sandboxing differences. Try opening the same page in the Notion web app (notion.so in a browser) to confirm the embed works, then check if the desktop/mobile app version supports that embed type.
Widget is cut off at the bottom
Drag the bottom resize handle of the embed block downward to increase height. If you have already reached Notion's maximum height, users can scroll inside the embed frame to see the rest. Alternatively, link to the Embed Link URL directly so users can view the widget in its own full-page tab.
Still stuck? Reach out on Discord or contact support. Share your widget's Embed Link and a screenshot of what you see in Notion and we will help you debug it.
FAQ
Does this work with Notion's free plan?
Yes. The Embed block is available on all Notion plans including the free tier. There are no plan restrictions on using embeds.
Can I embed a widget in a Notion database or table?
Not directly inside a database cell. However, you can open any database record as a full page and add an Embed block inside that page — so each row in your database can have its own embedded widget. You can also add an embed to any regular page that links to or summarizes a database.
Will the widget update automatically if I change it in Embeddy?
Yes. Because Notion embeds the live URL, any changes you make to your widget in the Embeddy dashboard are instantly reflected everywhere the widget is embedded — including in Notion. You do not need to update any links or re-embed anything.
Ready to embed your widget?
Head to your Embeddy dashboard to create or find your widget, copy the Embed Link, and drop it into any Notion page in seconds.