Video

A player for a YouTube link or an uploaded video file. It has a per-breakpoint aspect ratio, so a 16:9 video on desktop can become a square or portrait frame on a phone.

Not currently on any section

No section in the theme lists this block at the moment. Background video in the Hero and Featured Banner is a section setting, and Text & Image Split uses the Media block. Keep this page for reference if the block gets wired into a section later.

Settings

Setting	What it does
Video
Video URL	A YouTube link. Defaults to a placeholder URL — replace it.
Video	An uploaded video file. Takes priority over Video URL when both are set. Use this one if you want autoplay and looping.
Video size
Aspect ratio (mobile)	21:9, 16:9 (default), 4:3, 1:1, 3:4, 9:16, 9:21, or Custom.
Custom aspect ratio (mobile)	Shown as a field regardless; only used when the ratio above is Custom. Format 16/9. Defaults to 16/9.
Aspect ratio (tablet)	Same options. Default 16:9. Applies from 640px up.
Custom aspect ratio (tablet)	As above.
Aspect ratio (desktop)	Same options. Default 16:9. Applies from 1024px up.
Custom aspect ratio (desktop)	As above.
Video controls
Autoplay video	Off by default. Uploaded videos only — has no effect on a YouTube URL.
Loop video	Off by default. Uploaded videos only.
Mute video	On by default. Uploaded videos only.
Show video controls	On by default. Shows play, pause and volume.
Video layout	Contain fits the whole video inside the frame; Cover fills it and crops. Defaults to Contain.
Block ID	Optional anchor ID.

Uploaded file wins over the URL

If both fields are filled, the uploaded file plays and the YouTube URL is ignored. Clear the file if you want the YouTube embed.

Playback settings only apply to uploaded video

Autoplay, Loop and Mute control the theme’s own player, which is only used for uploaded files. A YouTube embed uses YouTube’s player, which manages its own behaviour.

Autoplay needs Mute left on

Browsers block autoplay when sound is on. Turning off Mute video while Autoplay is on means the video simply won’t start.

Custom aspect ratios

The custom field is always visible, even when the ratio dropdown isn’t set to Custom — it’s simply ignored in that case. Enter the value with a slash: 16/9, 4/5, 21/9.

Tips

• Prefer YouTube for anything long. A YouTube embed loads a lightweight placeholder and only pulls in the player when someone clicks it, so it costs the page almost nothing until it’s used.
• Reserve uploaded files for short, silent loops used as visual texture.
• Set a portrait ratio on mobile (9:16 or 3:4) for footage shot vertically, rather than letterboxing it into a 16:9 frame.