Video

The Video block plays a video — either a file from the media library or a YouTube/Vimeo URL — at a chosen aspect ratio, with optional poster image and SVG mask shape.

When to use it

Hero / showcase video on a marketing page
Embedded YouTube or Vimeo clip with a custom poster
Video framed inside a non-rectangular SVG mask (circle, blob,

custom shape)

When not to use it

Background video that fills a section — use Section with a

background-video setting instead

A grid of multiple videos — wrap several Video blocks in a Grid
Audio-only — there is no audio block; use Code with an <audio>

embed

Source

The block has two source modes that swap the top row:

Video URL — text input (default mode)

YouTube / Vimeo / direct .mp4 URL. When the URL is a YouTube link, a thumbnail preview appears under the row automatically.

Select File — button

Picks a video file from the media library. When a file is chosen, the URL row is hidden and the row shows the filename + a Remove button.

Poster — button (or preview thumb when set)

Picks an image used as the video's poster (still frame shown before play). When a poster is picked, the button is replaced by a 40×26 thumb preview + a × button to remove it.

Aspect ratio — button group: 16:9 · 4:3 · 21:9 · 1:1 · 9:16 (default: 16:9)

Sets the video's display ratio. Hidden when a Mask is selected (masks override aspect) and when a local file is selected (file keeps its native ratio).

Toggles

Autoplay (default: off) — left-aligned. Video plays on load.

Browsers require muted for autoplay to work.

Controls (default: on) — right-aligned. Show native player

controls.

Lazy-loading is always on — there is no toggle.

Width — slider, 20–100% (default: 100)

Block width as a percentage of its container.

Mask

Picks an SVG mask shape that clips the video to a non-rectangular outline. The picker loads available masks from the media library into a horizontal row of thumbnails. Click a mask to apply, click again to clear.

When a mask is set, the Aspect ratio row hides (the mask's viewBox dictates the ratio).

Entrance animation

Standard entrance-animation widget at the bottom of the panel — fade / slide / zoom / etc., with timing controls. Same widget that appears on most blocks.

Per-device overrides

Width has separate Tablet and Mobile values.

Common overrides:

Width — 100% on tablet/mobile so the video fills the column
Autoplay — sometimes off on mobile to save data

Common patterns

Hero showcase video

Source: a YouTube URL · Poster on (custom still) · Aspect 16:9 · Autoplay off · Controls on · Width 100.

Looped product reel (file)

Source: Select File (mp4 in media library) · Autoplay on · Controls off · Width 80%. Pair with an external Mute fallback — muted is required for autoplay.

Masked portrait video

Source: file or URL · Mask: pick a circle/blob SVG · Width 60% · Autoplay off. Aspect ratio row hides automatically.

blocks/image — for static images, also supports SVG masks
blocks/carousel — for cycling between several videos / images
blocks/section — wrap Video in a Section for full-bleed

hero treatment