How to Embed Video in SharePoint Modern Page: My Complete Step-by-Step Guide

Mack John ~ Published: November 27th, 2025 ~ SharePoint ~ 7 Minutes Reading

I still remember when the embedding feature from an external source was introduced in SharePoint versions 2013 and 2016, and by using this feature, I helped many teams build modern and engaging SharePoint sites. The thing I noticed was how powerful videos can be. Most of the time, it happens that the client asks me how to embed video in SharePoint modern page because most of them find it confusing at first.

In this article, from my experience, I will share every method that I personally use to embed SharePoint video on modern pages, and also explain common issues and how to handle them during real projects.

Why Embedding Videos in SharePoint Matters

While working with SharePoint for a long time now, one thing that I have noticed is that users prefer watching videos over reading long and boring documents. Adding videos helps in:

  • Improving employee engagement
  • Delivering training more efficiently
  • Making pages visually appealing
  • Reducing support tickets
  • Enhancing communication

That’s the reason why learning how to embed video in SharePoint modern page is important for anyone who is managing sites, and if you want to deliver content in a clean and modern way.

Also read: Download video from SharePoint

How to Embed Video in SharePoint Modern Page?

From my past experience, I have found 5 methods to embed videos; here they are:

#Method 1. Embed YouTube or Third-Party Videos Using the “Embed” Web Part

It is one of the most common and simplest ways I embed SharePoint video from an external or public platform.

Steps I follow while working on any project:

  1. Open the SharePoint site where you want to add the Video
  2. Click Edit on the page
  3. Select the + Icon to add a web part
  4. Choose the Embed web part
  5. Paste the YouTube, Vimeo, or other platform’s embed code or URL
  6. Click Publish or Republish

This method only works if the video is publicly accessible or allowed to be used by the platform. Let’s dive into the next method of how to embed video in SharePoint modern page​

#Method 2. Embed Microsoft Stream Videos ( Classic Stream )

 To date, some of the organisations still use the Microsoft Stream( Classic ) to store training and company videos.

How I embed Stream Classic videos:

  1. Open the video in Stream Classic
  2. Click Share > Embed
  3. Copy the embed code
  4. Go to the SharePoint page and choose Embed Web Part
  5. Paste the embed code.

You can follow the above steps if your organisation still uses Stream Classic. Since Microsoft is moving Stream videos fully to SharePoint and OneDrive, you can rely on the new methods now.

#Method 3. Embed Videos Stored Directly in SharePoint or OneDrive ( New Stream )

Nowadays, in SharePoint, videos are uploaded directly into the SharePoint document libraries or OneDrive. These are the steps I follow to better understand how to embed video in SharePoint modern page​

To embed a SharePoint video stored in a library, I do this:

  1. Upload the video to a SharePoint document library
  2. Open the Video file
  3. Click Copy Link from the top bar
  4. Go to the SharePoint page > Edit
  5. Add the File Viewer Web Part
  6. Past the video link

Related article: Document Repository SharePoint

#Method 4. Use the “Text” Web Part to Embed via iFrame Code

Due to some security reasons, the “Embed” web part gets refused for custom platforms. In these kinds of situations, I add a video using a simple iframe within a text web part.

Steps:

  1. Insert a Text Web Part
  2. Click </> HTML mode
  3. Paste the iFrame embed code.

For example:

<iframe width="560" height="315" src="https://example.com/video" frameborder="0" allowfullscreen></iframe>

This method will give you flexibility, but you need to make sure that your organization’s security policy allows custom iFrame. After doing this, you will get to know more about how to embed video in SharePoint modern page​

#Method 5.  Using the Highlighted Content Web Part ( For Video Catalogs )

In case you want to showcase multiple videos instead of embedding one, you can use the Highlighted Content Web Part.

These are some steps that I follow:

  • Open the SharePoint modern page and click Edit.
  • Click the + icon and add the Highlighted Content web part.
  • Choose the content source, i.e, site, library, or folders.
  • In the filter section, set Type > Videos.
  • Apply additional filters if needed (metadata, tags).
  • Select how you want to sort the videos (most recent, name, modified).
  • Pick a layout such as grid, list, filmstrip, or carousel.
  • Make sure users have permission to access the video library or folder.
  • Click Publish/Republish to make the video catalog live.

Once you set it up to pull videos from the document library or folder you choose, SharePoint will automatically show them in a clean thumbnail gallery.

Tips I Follow for Smooth Video Embedding in SharePoint

Here are some habits that I follow to ensure everything works smoothly.

  1. Always check permissions

Sometimes, after learning how to embed video in SharePoint modern page​, users are unable to see the embedded video because they don’t have access to the library or platform. I always make sure that the video is shared with the right groups before embedding, with proper SharePoint Online permissions.

  1. Ensure HTTPS links

Sometimes, SharePoint blocks insecure content ( HTTP) due to security reasons or when it finds something suspicious about it. So, in order to prevent display errors, you need to avoid non-secure URLs.

  1. Optimize video size

Large videos always slow down the loading of the content. So, in these scenarios, I always suggest compressing or compacting videos before uploading, unless high resolution is absolutely mandatory.

  1. Use an organizational source for sensitive content

If you have some internal training or confidential videos, always prefer storing videos in SharePoint or OneDrive to ensure compliance. This is what I always do while working for the clients.

Additional Resource: How to Archive SharePoint Site

Why Some Videos Don’t Display on SharePoint ( My Common Fixes )

Some users still face issues like blank videos or “embed blocked ” warnings, even after understanding how to embed video in SharePoint modern page. These are the common causes I faced:

  • Restrictions from the external platform can prevent some videos from being embedded because there might be some limited permissions from the creator’s end. 
  • Embedding iFrames blocked by SharePoint policy” usually appears when the admin disables custom iFrames from their end due to security reasons.
  • Browser security settings can sometimes be too strict, and these strict privacy settings may block important scripts from loading properly.
  • Incorrect embed code can be a reason that the video fails because copying only the code or changing its parameters often breaks the embedding process.
  • Missing user permission for the video file: This is an issue that mostly happens when the video loads only for the person who uploaded it. You just need to give others permission to the file.

What If You Are Migrating SharePoint Data?

I have worked with the organisations that decided to reconstruct their SharePoint in order to reorganize libraries, tenants, or sites where hundreds of videos were involved.

Moving these manually becomes risky because:

  • Metadata gets lost
  • Permissions break
  • Video links stop working
  • Pages referencing embedded video show errors.

That’s why, during complex migration, I always rely on a professional and secure tool like SharePoint Online Migration Tool.

The reasons are:

  • Retains video library structure
  • Keeps permissions intact
  • Maintains embedded links
  • Supports large sites and multiple libraries
  • Reduces manual fixes after migration
Author’s Verdict

Understanding how to embed video in SharePoint modern page is one of the best ways to make your site more engaging and user-friendly. Each method has its own advantage, whether you are embedding YouTube Videos or internal SharePoint videos. Embedding videos helps you avoid reading long messages. 

If you ever consider restructuring or migrating SharePoint sites, using a reliable and professional tool is a wise decision it ensures all your embedded videos and page elements move safely without breaking anything.