Video
Embed a video from your media library, YouTube, or Vimeo.
The Video block plays a video on the page, pulling from your media library or from a YouTube or Vimeo URL. It is what you reach for when a video needs to sit in the flow of the page and behave as content, not as a background texture.
For a moving background rather than a played-in video, set a video background on any block from the Backgrounds controls instead.
Adding one
- Select the section or container to hold it.
- Open the inserter and search "video".
- Pick the Video block, then set its source in the settings panel.
Settings
In the video's own panel. The shared design panel covers spacing, colour, borders, and effects.
| Setting | What it does | Reach for it when |
|---|---|---|
| Source | Static (a fixed URL or media-library file) or dynamic (pulled from an ACF field) | Dynamic when each post or product carries its own video |
| URL / file | The YouTube or Vimeo URL, or the media-library video for static source | Every time; nothing plays without a source |
| Start / End | Trim the playback to a time range in seconds | Embedding only a clip from a longer file |
| Ratio | Aspect ratio of the video container; defaults to 16:9 (56.25%) | Tall or square videos that need a different ratio |
| Autoplay | Video starts playing on load | Ambient or demo loops; mute is required for autoplay to work in most browsers |
| Mute | Video plays without sound | Autoplay loops, or anywhere audio would be unwelcome |
| Loop | Video restarts when it ends | Background-style loops, product demos |
| Controls | Show the browser's native playback controls; on by default | Off for a clean ambient loop with no UI |
| Branding | Show the platform's logo on the embed (YouTube) | Off to keep the embed neutral |
| Privacy | Use the privacy-enhanced embed URL (YouTube: youtube-nocookie.com) | When you want to avoid setting cookies on visitors who have not pressed play |
| Related | Show related videos at the end of playback (YouTube) | Off when you want viewers to stay on the page |
| Overlay | A layer that sits over the video, positioned independently | A custom play button, a caption layer, or a poster image that disappears on play |
Styling
The shared design panel covers all visual controls: size, spacing, colour, borders, and effects, each per breakpoint. The overlay is a child layer with its own positioning controls, so you can place a play icon or caption wherever it needs to sit.
Accessibility
Videos with dialogue or meaningful audio need a transcript or captions. The Video block does not generate these, add a caption track to the media file itself, or link to a transcript below the block. For autoplay videos, the combination of mute and no controls removes any way for a visitor to stop or pause the video; leave controls on, or provide an equivalent way to pause.