How to Embed Video in SharePoint Modern Page | Web Part Fit

Use File and Media for SharePoint-hosted video, or Embed for YouTube, Vimeo, and approved iframe sources.

A page video feels broken only when the wrong web part is picked; the steps for how to embed video in SharePoint modern page depend on whether the clip is stored in Microsoft 365 or hosted outside it. SharePoint handles both, but the web part choice changes the permissions, playback, and failure points.

For a video file stored in SharePoint, OneDrive, or a site library, use the File and Media web part. For a video hosted on an external platform, use the Embed web part with a share URL or embed code from the host.

Embed Video In A SharePoint Modern Page: Web Part Choices

SharePoint modern pages do not have one universal video button. SharePoint uses web parts, so the source of the video decides the method.

Pick the web part before copying links or uploading files. That one decision prevents most blank players, permission errors, and iframe blocks.

Which Web Part Should You Use?

The File and Media web part fits when your organization owns the video file. The Embed web part fits when the video lives on a site that gives a share URL or iframe code.

Use this split in daily work:

• Internal training clip: upload it to the site library, then place it with File and Media.
• Public marketing clip: copy the host’s embed code, then place it with Embed.
• Department video shelf: use a library view or video page template when several clips belong together.
• Landing page feature: use Hero when the video needs a large tile.

Add A SharePoint-Hosted Video

A SharePoint-hosted video should be added from edit mode through the page’s web part picker. The viewer will see a player directly on the published page when file permissions allow access.

1. Open the modern page and select Edit in the top-right corner.
2. Select the Toolbox on the right, or hover under the title area and select the circled +.
3. Select See all web parts, then choose File and Media. Some tenants may still show the picker name as File viewer.
4. Choose a recent video, browse a site library, upload from your computer, or paste a file link.
5. Review any sharing prompt. Choose Create link when the page audience needs access beyond the file’s existing permissions.
6. Add a short description under the web part if the page needs context for the video.
7. Select Publish or Republish when the page is ready for viewers.

The video player appears on the page, and viewers can press play without leaving the modern page. If the player loads but some viewers cannot watch, the file permission is the problem, not the web part.

Microsoft’s current page says a single SharePoint video can play inline through the File and Media web part, while external embeddable content belongs in the Embed web part. Microsoft video web part guidance also notes that video links can use different web parts.

Add A YouTube, Vimeo, Or Iframe Video

An external video needs the Embed web part, not File and Media. SharePoint can display external content only when the host allows embedding and the site collection permits that domain.

1. Open the video on the hosting site and select Share.
2. Copy the normal share URL, or copy the iframe from Embed or when the host provides one.
3. Open the SharePoint page and select Edit.
4. Select the Toolbox or the circled +, then choose Embed.
5. Select Edit properties, then paste the URL or iframe into Website address or embed code.
6. Save the page, then select Publish or Republish.

The external player should render inside the web part. If SharePoint shows a domain message, ask a site collection admin to review HTML Field Security rather than changing the video code again.

Why Does The Embed Web Part Show An Error?

The Embed web part usually fails for one of three reasons: the host blocks iframe playback, SharePoint blocks that domain, or the copied link is a watch page rather than an embed link. The error text often points to the right fix.

Site collection admins can allow specific iframe domains through Settings > Site settings > HTML Field Security. Broadly allowing every domain creates more risk, so a short approved-domain list is the better admin choice.

Publish With Fewer Playback Problems

The final check should test the page like a viewer, not like the editor. Editors often have wider file access, so a video that works for you may fail for the audience.

• Open the page in a private browser window or test account before announcing it.
• Confirm the web part matches the video source: File and Media for owned files, Embed for outside players.
• Check the video file permissions against the page audience.
• Use a short title or description under the player so viewers know why the video is there.
• Use Quick Links when the host refuses iframe playback and an inline player will not work.
• Use Hero only when the video needs a larger tile than a normal player.

For most modern pages, the winning setup is simple: store internal video in SharePoint and place it with File and Media; embed public-hosted video with Embed; use link-style web parts only when playback inside the page is not available.

Send us your feedbackTell us what you thought about this post

Name * Email *

Your comment *

Quick check — what is …? *

Send feedback