Getting Started with the Brightcove M365 Connector for SharePoint

Releases

The Brightcove M365 Connector for SharePoint is the SPFx-based connector for SharePoint Online (M365). The table below lists the current and past releases of the connector. For full release details, click the version number or scroll to the corresponding section.

For installation steps, see the Installation Guide. For day-to-day use of the connector's web parts and features, see the User Guide.

Version 1.2.0.0 (September 2026)

Version 1.2.0.0 adds a Videos tab to the Content Management page for managing your video library from SharePoint, brings video search to parity across every place that lists videos, adds thumbnails and a playlist picker to the web parts, and fixes sizing and popup playback issues in the Experience web part. It also removes the 100-item cap on the content selectors.

Only the SharePoint package changes in this release. The Proxy API (Azure Function App) has no functional changes, so existing installations do not need to redeploy functionapp.zip. The release download still includes functionapp.zip for new installations; it carries dependency updates only. See Upgrade notes below.

What's new

Video management (Content Management page)

• New Videos tab between Upload and Playlists. It lists the account's videos with a thumbnail and duration, status (Active, Inactive, or Processing), reference ID, tags, folder, and created and modified dates.
• Search videos by name or ID, filter by folder, and sort by Name, Created, or Modified.
• Click a video's name to open the Edit Video dialog. The Overview tab covers status, name, reference ID, short and long description, tags, and folder, with a character counter on each field. The new Custom Fields tab edits the account's custom fields.
• Select one or more videos and click Delete to delete them from Video Cloud after confirmation.
• Videos that are still processing refresh automatically until ingestion completes.

See the User Guide, Section 4.3.

Folders in the Edit Video dialog

• The Folder picker now shows the video's current folder when the dialog opens. Choose a different folder to move the video, or choose No folder to remove it from its folder. This applies to the edit dialog on both the Upload tab and the Videos tab.

Search

• Video search behaves the same in the Videos tab, the Video web part's selector, and the Add more videos dialog for manual playlists: type a name or ID and press Enter. Results match the video name, ID, reference ID, description, and tags.
• Playlist search in the Playlists tab and in the Playlist web part's selector now matches partial names as well as full names and IDs. The Experience selector accepts the same kinds of terms.
• Every video list shows a row number and a result count, such as 124 items or 3 selected · 12 results.

Content selectors

• The Video and Playlist selectors, the Videos tab, and the Add more videos dialog load more rows as you scroll instead of stopping at 100 items.
• Video lists have sortable Name, Created, and Modified columns. Sorting is unavailable while a folder filter is active.

Thumbnails

• The Video web part shows the video's poster image while the player loads, sized to match the final player frame.
• Thumbnails appear on upload cards once Brightcove generates one, in the Videos tab, and in the smart playlist Videos tab.

Upload

• The Content Management upload area accepts video files only (MP4, MOV, M4V, MKV, WMV, AVI, MPG, MPEG, FLV, and WebM). Files of any other type are rejected with a message that names the file, whether they are dropped onto the upload area or chosen with Browse for Videos.

Playlists

• New smart playlists default to a Limit Number of Videos of 100 (the allowed range is 1 to 1000), and playlist video lists load in pages so playlists with many videos display completely.
• The Playlist web part has a new Playlist UI property group: an optional playlist picker (as a sidebar or a strip below the player), an Up next countdown overlay, a Repeat Playlist toggle, and a configurable Auto-Advance Delay. Playlists advance to the next video automatically.
• The Up next overlay and the horizontal picker stay aligned with the player when the player is narrower than the page section.
• Start Muted now takes effect in both the Video and Playlist web parts.

See the User Guide, Section 5.3.

Experience web part

• Legacy In-Page Experiences embedded as an iframe now default to the full width of the web part at a 16:9 aspect ratio when the experience has no stored dimensions. Previously the browser fell back to a 300 by 150 pixel frame, which made grid layouts collapse to a single column. Pages that already contain an unsized experience iframe are corrected automatically the next time they render.
• Embed Builder popup players now play on SharePoint pages. Previously, clicking a video in an Embed Builder experience opened an empty overlay: SharePoint's page script loader captured the Brightcove player that the popup loads, so the player never initialized. The web part now loads that player in a way the SharePoint loader does not interfere with, then hands control back to the experience. If the player still cannot be loaded (for example, a network proxy or ad blocker filters players.brightcove.net), the web part writes a warning to the browser console. See Trusted script sources below.

Connector Settings

• On the Proxy Configuration tab, Save and Test Connection stay disabled while the saved settings load, while either field is empty, and while either field has a validation error.

Trusted script sources

If your SharePoint Online tenant enforces Content Security Policy (CSP), Embed Builder experiences need three trusted script sources, not two. In addition to https://*.ipx.bcvp0rtal.com/ (the experience iframe and its helper script) and https://players.brightcove.net/ (the player that the popup injects into the page when a viewer clicks a video), add https://cdn.jsdelivr.net/, which vertical video playlists load on mobile devices. Allow all three so every Embed Builder feature loads on every device. See the Installation Guide, Section 5.1.

Known limitations

• Legacy In-Page Experiences embedded with the iFrame embed type render at a 16:9 aspect ratio when the experience has no stored dimensions. Content taller than 16:9 scrolls inside the iframe. Clicking a video opens the experience's own video view inside the iframe, with an All Videos link back to the grid, and plays inline; the experience's lightbox setting does not apply inside an iframe on another domain.
• On tenants that enforce CSP, the JavaScript embed type for legacy In-Page Experiences does not render, even with https://players.brightcove.net/ as a trusted script source, because the experience script inserts an inline script that CSP blocks. Use the iFrame embed type on these tenants.
• Video search matches whole words. Searching for Exxon does not find a video named ExxonMobil. Playlist and experience search match partial names.
• Creating and managing In-Page Experiences (legacy IPX) and Embed Builder experiences from SharePoint is not supported. Use Brightcove Video Cloud Studio.
• Editing video poster and thumbnail images from SharePoint is not yet supported. Use Brightcove Video Cloud Studio.
• Manual text track management (upload or URL) from SharePoint is not yet supported. Autocaption is available during upload; for additional text tracks, use Brightcove Video Cloud Studio.
• Assigning a folder to many uploads at once is not supported. Set the folder per video in the Edit Video dialog.
• Teams and Viva Connections support is not included in this release.

Upgrade notes

Only the SharePoint package changes in this release. The Proxy API (Azure Function App) has no functional changes, so functionapp.zip does not need to be redeployed and no Azure work is required. To upgrade, upload the new brightcove-video-connector.sppkg to the Tenant App Catalog, replace the existing file, and enable it, then update the app on each site where it is installed. Existing web part configurations, connector settings, and account credentials are preserved. Pages that already contain a legacy experience iframe are resized on their next render; no re-insertion is required. If your tenant enforces CSP and you use Embed Builder experiences, add https://cdn.jsdelivr.net/ to the trusted script sources as part of the upgrade. See the Installation Guide, Section 5.5 for step-by-step upgrade instructions.

Version 1.1.0.0 (May 2026)

Version 1.1.0.0 adds playlist management and support for Embed Builder experiences to the connector, plus a batch of search and UX improvements. No installation changes are required to upgrade beyond redeploying the updated brightcove-video-connector.sppkg and functionapp.zip.

What's new

Playlist management (Content Management page)

• New Playlists tab in the Content Management web part for creating, editing, and deleting manual and smart playlists, mirroring the workflow in Brightcove Video Cloud Studio.
• Add videos to a manual playlist via a multi-select picker with name-search filters; videos already in the playlist are automatically filtered out to prevent duplicates.
• Manage video order in manual playlists with up/down reorder and per-row remove.
• Smart playlist editor now exposes a Combine parameters toggle (Match all vs. Match any) accessible from the equalizer icon next to the Parameters header, matching Brightcove Studio's smart-playlist UX.
• New Last activated date parameter type for smart playlists.
• Smart playlist Videos tab now displays a human-readable summary of the active criteria.

See the User Guide, Section 4.4 for end-to-end usage.

Embed Builder support for the Experience web part

• New Embed Experiences tab in the Experience web part's selector dialog, sourced from Brightcove's Embed Builder. Embed Builder sites are hosted on *.ipx.bcvp0rtal.com.
• Renderer adds a third branch for Embed Builder snippets (iframe + in-page-manager.min.js) alongside the existing legacy iframe and JavaScript embed paths.
• Author-canvas (edit mode) awareness: the iframe renders but the in-page-manager.min.js helper script is suppressed in the SharePoint workbench to avoid third-party JS in author canvas.
• CSP warning displayed beneath the Embed Type radio when JavaScript embed is selected on the legacy Experiences tab.

See the User Guide, Section 5.4 for end-to-end usage. If your SharePoint Online tenant uses Content Security Policy (CSP) enforcement, also add *.ipx.bcvp0rtal.com as a trusted script source; see the Installation Guide, Section 5.1.

Search and UX improvements

• Video picker search no longer returns zero results for special characters or short terms (the trailing-wildcard issue has been fixed; search terms are sanitized and phrase-matched).
• Playlist picker search now uses Brightcove Studio's pattern (single-word search, sorted by name), avoiding the multi-term 500 errors that occasionally surfaced in v1.0.0.0.
• Smart playlist parameter values no longer show literal Brightcove canonical wrapping in the UI.
• Error states in search now keep the search input interactive so users can clear or retry without re-opening the dialog.

Known limitations

• Creating and managing In-Page Experiences (legacy IPX) from within SharePoint is not yet supported. Use Brightcove Video Cloud Studio's Gallery module.
• Managing (create, edit, delete) Embed Builder experiences from SharePoint is not supported; it remains a Studio activity.
• Editing video custom fields, video poster, and thumbnail images from SharePoint is not yet supported. Use Brightcove Video Cloud Studio.
• Manual text track management (upload or URL) from SharePoint is not yet supported. Autocaption is available during upload; for additional text tracks, use Brightcove Video Cloud Studio.
• Video deletion from the Content Management page is not supported. Use Brightcove Video Cloud Studio.
• Teams and Viva Connections support is not included in this release.

Version 1.0.0.0 (March 2026)

The Brightcove M365 Connector for SharePoint is a completely new connector built from the ground up on the SharePoint Framework (SPFx). It replaces the legacy Brightcove SharePoint Connector (Add-In version 4.1.2.0), which will stop working in SharePoint Online (M365) on 2 April 2026 due to Microsoft's retirement of the Add-In framework.

What's included

Authoring web parts

The following web parts are available in the SharePoint toolbox:

• Brightcove Video: Select and embed a single Brightcove video with configurable playback options (autoplay, muted start), player controls (seek forward/backward, fullscreen, picture-in-picture, control bar sizing), and player sizing (responsive or fixed, with preset and custom aspect ratios).
• Brightcove Playlist: Select and embed a Brightcove playlist with the same playback, controls, and sizing options as the Video web part.
• Brightcove Experience: Select and embed a published Brightcove In-Page Experience (IPX) with a choice of iFrame or JavaScript embed type. JavaScript embed is required for customers using Brightcove domain restrictions on experiences (Video and Playlist web parts work seamlessly with domain-restricted content without additional configuration).

Admin and content management pages

The following pages are provisioned automatically when the connector is added to a SharePoint site:

• Connector Settings (BrightcoveConnectorSettings.aspx): Configure the Proxy API connection (URL and API resource) with built-in connection testing and diagnostics (Copy Support Bundle). Manage Brightcove account credentials (add, edit, delete, test) with secure storage in Azure Key Vault.
• Content Management (BrightcoveContentManagement.aspx): Upload new videos via drag-and-drop, file browse, or URL. Includes built-in Autocaption support for automatic caption generation during upload. Edit video details (name, description, tags, reference ID, folder, active/inactive status) directly from SharePoint.

Architecture highlights

• Secure by design: Brightcove API credentials are stored as encrypted secrets in Azure Key Vault and never exposed to the browser. All Brightcove API calls are made server-side through the Proxy API.
• Microsoft Entra ID authentication: The Proxy API validates OAuth 2.0 JWT tokens issued by Microsoft Entra ID, ensuring only authenticated SharePoint users can access Brightcove resources.
• Same-tenant and cross-tenant support: The connector supports deployments where the Azure subscription and SharePoint Online are in the same Entra ID tenant or in different tenants.
• Tenant-scoped credential isolation: Brightcove account credentials are scoped by the Entra tenant ID (tid claim) of the requesting user, enabling secure multi-tenant deployments from a single Proxy API instance.
• Built on modern technology: SPFx app (React + TypeScript), Proxy API (Node.js 22 + TypeScript on Azure Functions v4, Flex Consumption plan).

Compatibility

Distribution

The connector is distributed directly by Brightcove as compiled packages. It is not available as open source, via GitHub, or through the Microsoft AppSource marketplace. Customers should contact their Brightcove Account Manager to request the connector.

Known limitations

• Playlist management (create/edit playlists) from within SharePoint is not yet supported. Use Brightcove Video Cloud Studio.
• Experience management (create/edit IPX) from within SharePoint is not yet supported. Use Brightcove Video Cloud Studio.
• Editing video custom fields from SharePoint is not yet supported. Use Brightcove Video Cloud Studio.
• Editing video poster and thumbnail images from SharePoint is not yet supported. Use Brightcove Video Cloud Studio.
• Manual text track management (upload or URL) from SharePoint is not yet supported. Autocaption is available during upload; for additional text tracks, use Brightcove Video Cloud Studio.
• Video deletion is not supported from the Content Management page. Use Brightcove Video Cloud Studio.
• Teams and Viva Connections support is not included in this release.

Support

For help with this connector:

1. Use the Copy Support Bundle button in the Connector Settings page to capture diagnostic information.
2. Contact your Brightcove Account Manager or CSM for migration planning and deployment guidance.
3. Open a support case at Brightcove Support and include the support bundle output along with a description of the issue.