Blocks

Video Block

2 min read

> Embed videos from YouTube, Vimeo, or self-hosted sources with full playback control.


Overview

The Video block embeds videos from popular platforms or your own server. It supports YouTube, Vimeo, and self-hosted video files with customizable playback options, aspect ratios, and responsive sizing.


Fields

FieldDescription
HeadingOptional section title above the video
SubheadingSupporting text below the heading
SourceVideo source: YouTube, Vimeo, or Self-hosted
Aspect RatioVideo dimensions: 16:9, 4:3, 21:9, or 1:1
WidthMaximum width: Full, XL, Large, or Medium
CaptionOptional caption text below the video
Content WidthControl the maximum width of the content area
AnimationEntrance animation effect

Source-Specific Fields

YouTube

FieldDescription
YouTube URLFull YouTube video URL (required)

Vimeo

FieldDescription
Vimeo URLFull Vimeo video URL (required)

Self-Hosted

FieldDescription
Video URLDirect URL to MP4, WebM, or OGG file (required)
Poster URLThumbnail image shown before playback

Playback Options

OptionDescription
AutoplayStart playing automatically on page load
MutedStart with audio muted (required for autoplay)
LoopContinuously repeat the video
ControlsShow player controls (play, pause, volume, etc.)

Aspect Ratios

RatioBest For
16:9Standard widescreen (most common)
4:3Traditional/older video formats
21:9Cinematic ultra-wide content
1:1Square format (social media style)

Tips

  • For autoplay to work, the video must also be muted (browser requirement)
  • YouTube and Vimeo handle their own responsive behavior
  • Self-hosted videos should be optimized for web delivery

Examples

Choose Theme