How to Embed a Widget in SharePoint
SharePoint Online includes a built-in Embed web part that accepts website URLs and iframe embed codes. Drop your Embeddy widget URL into the Embed web part and your widget renders live on any SharePoint page — no custom development required.
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. - SharePoint Online edit access: You need edit permissions on the SharePoint site where you want to add the widget. The Embed web part is available on SharePoint Online (Microsoft 365) — it is not available in SharePoint Server on-premises by default.
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 Web Part (URL)
Recommended — cleanest approach for URL-based embeds
The Embed web part is SharePoint's native component for displaying external content inline on a page. It accepts a website URL and renders it inside an iframe automatically.
- 1
Edit your SharePoint page
Navigate to the page where you want the widget. Click Edit in the top-right corner to enter edit mode.
- 2
Add the Embed web part
Hover over a section and click the + (plus) icon. In the web part picker, search for Embed and select it. The Embed web part will be inserted on the page.
- 3
Paste your Embeddy widget URL
A property pane opens on the right. In the Website address or embed code field, paste your Embed Link:
https://embeddy.ai/webhost/WIDGET_ID?widget_props_id=PROPS_ID
- 4
Click "Apply" or press Enter
SharePoint will validate the URL and render a live preview of your widget directly inside the web part. If the URL is valid, you will see the widget appear within a few seconds.
- 5
Republish the page
Click Republish (or Publish for a new page) in the top-right corner. Your embedded widget is now live for all page visitors.
Tip: You can add multiple Embed web parts to the same page. Each one can display a different Embeddy widget — useful for dashboards with several widgets side by side.
Method 2: Embed Web Part (iframe Code)
Alternative — use iframe snippet for more control
The same Embed web part also accepts raw <iframe> embed codes. This gives you more control over dimensions and attributes.
- 1
Copy the iframe code from Embeddy
In the Embeddy dashboard, select your widget and copy the full iframe embed code from the Share / Embed panel.
- 2
Paste the iframe code into the Embed web part
Follow steps 1-2 from Method 1 to add the Embed web part, then paste the full iframe code in the input field:
<iframe src="https://embeddy.ai/webhost/WIDGET_ID?widget_props_id=PROPS_ID" width="100%" height="500" frameborder="0"></iframe>
- 3
Apply and publish
Click Apply to preview, then Republish the page. SharePoint will render the iframe inline.
Note: Your SharePoint admin may have restricted which domains are allowed in the Embed web part. If you see a "This content can't be shown" message, ask your admin to allowlist embeddy.ai in the HTML Field Security settings. See Troubleshooting below for details.
Resizing & Layout
SharePoint gives you several ways to control how the Embed web part looks on the page.
Section Layouts
Use SharePoint's section layout options (one column, two columns, three columns, one-third left, one-third right) to control the width of the Embed web part relative to other content on the page.
Height via iframe
If you use Method 2 (iframe code), you can set a specific height attribute in the iframe tag (e.g., height="600") to control the visible height of your widget.
Full-width sections: For maximum widget visibility, place the Embed web part in a full-width section. Go to the section settings and choose Full-width column for a true edge-to-edge layout.
Limitations
SharePoint embeds work well but have a few platform-level constraints to be aware of:
Domain allowlisting
SharePoint admins can restrict which external domains are permitted in the Embed web part. If embeddy.ai is not on the allowlist, the embed will be blocked. Contact your SharePoint admin to add it.
Classic sites not supported
The Embed web part is only available on modern SharePoint pages. Classic SharePoint sites use a different page model and do not have the Embed web part. You would need to use a Script Editor or Content Editor web part on classic pages, which may require admin approval.
No auto-resize
The Embed web part does not auto-adjust its height based on widget content. If your widget content is taller than the default embed height, users will need to scroll within the frame. Use the iframe method with an explicit height for best results.
SharePoint in Teams
When a SharePoint page is viewed as a tab inside Microsoft Teams, some embeds may be restricted by Teams' content security policy. Test the embed in both the SharePoint site and within Teams to confirm it renders correctly in both contexts.
Troubleshooting
"This content can't be shown" error
This typically means the domain is not allowed by your SharePoint tenant's security policy.
- Ask your SharePoint admin to add
embeddy.aito the tenant-level domain allowlist in the SharePoint admin center under Settings > HTML Field Security. - Verify the URL is correct. Copy the Embed Link fresh from the Embeddy dashboard.
Embed appears blank or shows a spinner
Ensure your widget is published (not in draft mode) in the Embeddy dashboard. Also check that the widget visibility is set to Public — SharePoint cannot pass Embeddy authentication cookies, so login-required widgets will not load.
Embed web part is not available
The Embed web part may be disabled by your admin. Check with your SharePoint administrator whether the Embed web part has been turned off for your site or tenant. Also confirm you are on a modern SharePoint page, not a classic page.
Widget is cut off at the bottom
Use Method 2 (iframe code) and set an explicit height value in the iframe tag. For example, height="800" for taller widgets.
Still stuck? Reach out on Discord or contact support. Share your widget's Embed Link and a screenshot of the SharePoint error and we will help you debug it.
FAQ
Does the Embed web part work with SharePoint on-premises?
The modern Embed web part is a SharePoint Online (Microsoft 365) feature. For SharePoint Server on-premises, you would need to use a Content Editor or Script Editor web part to embed iframe code manually.
Can I embed a widget on a SharePoint communication site and a team site?
Yes. The Embed web part is available on both communication sites and team sites in SharePoint Online. The process is identical on both site types.
Will the widget update automatically if I change it in Embeddy?
Yes. The Embed web part loads the live URL each time the page is viewed. Any changes you make to your widget in the Embeddy dashboard are instantly reflected on the SharePoint page without needing to re-edit or re-publish.
Ready to embed your widget?
Head to your Embeddy dashboard to create or find your widget, copy the Embed Link, and add it to any SharePoint page using the Embed web part.