Video embed

2026.08.22 Content

Preview#

Benoît H. Dicaire speaking on stage at an Événements Les Affaires conference — The remote player loads only after the play button is activated.

Boundary#

The bridge accepts an 11-character YouTube video ID and constructs a privacy-enhanced embed URL. The thumbnail must be a local asset so opening the page does not contact the video provider.

Example

{{< video-embed id="M7lc1UVf-VE" title="YouTube Developers Live: Embedded Web Player Customization" thumbnail="/images/home/ben-speaking-les-affaires-2020.jpg" alt="Benoît H. Dicaire speaking on stage" >}}

When to use

A Markdown bridge to the shared deferred video-embed component.

Implementation

layouts/shortcodes/video-embed.html

Options

Option	Read by the shortcode template
`id`	Read by the shortcode template
`title`	Read by the shortcode template
`thumbnail`	Read by the shortcode template
`alt`	Read by the shortcode template
`caption`	Read by the shortcode template

Interface manifest

Kind: Shortcode
Category: Content
Status: Implemented
Implementation: Partial:layouts/partials/video-embed.htmlShortcode:layouts/shortcodes/video-embed.htmlCSS:assets/css/site.cssJavaScript:assets/js/site.jsi18n:videoEmbedPlayvideoEmbedWatch
Related interfaces: Video embed