Ga naar hoofdinhoud

CnVideoWidget

Video widget supporting YouTube/Vimeo/PeerTube embeds and Nextcloud-file/HTML5 playback.

Part of the dashboard widget library (v2). Registered with the dashboard widget registry and consumed by LaunchPad's widget grid. See the widget library overview and docs/architecture/cards-and-widgets.md.

The iframe used for youtube/vimeo/peertube sources sets referrerpolicy="strict-origin-when-cross-origin". Without it, the iframe inherits Nextcloud's own default Referrer-Policy: no-referrer security header, and YouTube's player rejects the embed with "Error 153: Video player configuration error" since it requires a referrer to validate the request.

Reference​

Props​

NameTypeRequiredDefaultDescription
contentobject\{\}Persisted content blob {sourceType, videoUrl, fileId, fileStreamingUrl, autoplay, muted, loop, controls, aspectRatio, posterUrl, error}. videoUrl is the canonical embed URL; error (when set) triggers the error placeholder.
placementobjectnullThe placement record (reserved — kept to match the renderer contract).