SharePoint Document Issues

How to Fix SharePoint Video Embed Refused to Connect Errors

Emma Brown Oct 1, 2026 869 views

Question details

Users encounter a 'refused to connect' error when trying to embed a SharePoint video via an iframe.

How to Fix SharePoint Video Embed Refused to Connect Errors

Product: SharePoint
Device & OS: not provided
Scenario: Embedding a SharePoint or Microsoft Stream video into a webpage or another SharePoint site using an iframe.
Observed behavior: The embedded iframe fails to load the video and instead displays a 'refused to connect' message on the page.

Before you start

Ensure you have the necessary viewing permissions for the SharePoint site and verify that the original video file has not been moved, renamed, or deleted.

Solution 1Recommended

Use the Official Embed Code from Microsoft Stream

The most reliable way to embed a SharePoint video is by generating the official iframe embed code directly from Microsoft Stream.

Manually copying the address bar URL into an iframe often triggers security restrictions. Using Stream's native share feature ensures the correct player parameters are included to bypass 'refused to connect' errors.

Open the video in Stream

Navigate to your SharePoint site and open the video file so that it plays in the Microsoft Stream interface.

Access the Share menu

Click on the 'Share' button located in the top menu bar or near the video player controls.

Generate the embed code

Select 'Embed code' from the dropdown menu, configure your preferred player size, and copy the provided iframe code to use on your target webpage.

Use the Official Embed Code from Microsoft Stream

Tip: Using the official embed code automatically formats the source URL correctly, preventing common cross-origin frame configuration errors.

Solution 2

Verify Video URL and Access Permissions

Check if the connection error is caused by a broken link or insufficient viewing permissions for the audience.

Solution 3

Use the SharePoint Embed Web Part

If you are embedding the video onto another SharePoint page, use the native Embed web part instead of writing custom raw iframe code.

Free Microsoft Office alternative

Looking for a Seamless Office Experience?

While troubleshooting SharePoint connections, consider WPS Office as a lightweight, highly compatible alternative for your daily document needs. It offers robust tools for Word, Excel, and PowerPoint files without the heavy resource usage.

1. Download the installer: Visit the official WPS Office website and click the download button to get the free installer.
2. Install the software: Run the downloaded file and follow the simple on-screen instructions to set up WPS Office on your computer.
3. Open and edit your files: Launch WPS Office to immediately start creating or editing your documents, spreadsheets, and presentations with ease.

Fully compatible with Microsoft Office formats (DOCX, XLSX, PPTX).Free and lightweight, ensuring smooth performance on any device.Easily insert and manage hyperlinks to cloud videos and resources in your presentations.Familiar user interface for a zero-learning-curve migration.

microsoft office alternative - wps office

Frequently Asked Questions

Why does my SharePoint iframe say 'refused to connect'?

This error typically occurs due to missing site permissions, an incorrect or expired video URL, or strict cross-origin restrictions (X-Frame-Options) that prevent the video from being displayed in an iframe on an external site.

Can external users view embedded SharePoint videos?

By default, SharePoint requires users to authenticate. External users will only see the embedded video if the SharePoint site or specific video file has been explicitly shared with them or configured for public, anonymous access.

How do I find the correct embed code for a Microsoft Stream video?

Open the video in Microsoft Stream, click the 'Share' button, and select 'Embed code'. This generates a verified iframe snippet with the correct player parameters optimized for external display.

Document & File Issues