Media

An image or a video in a single block — pick which with the Media type setting and the fields for the other one disappear. Used as the picture side of the Text & Image Split section.

Unlike the plain Image block, this one has its own alt text field, an optional separate mobile image, and an aspect ratio.

Settings

Setting	What it does
Media type	Image (default) or Video. Controls which fields below are shown.
Image	The image. Image only.
Mobile image	Optional alternative for small screens — usually a tighter crop. Falls back to the main image when empty. Image only.
Alt text	Describes the image for screen readers. Falls back to the image’s own alt text from the Files library. Image only.
Loading	Lazy (default) or Eager. Use Eager only for media above the fold. Image only.
Video	An uploaded video file. Keep it short and small — ideally under 1MB. Video only.
Autoplay	On by default. Starts the video without the visitor pressing play. Video only.
Loop	On by default. Repeats the video continuously. Video only.
Show controls	Off by default. Shows the browser’s play, pause and volume controls. Video only.
Aspect ratio	Natural (default, the image sets its own height), Square (1:1), 4:3, 3:4, 16:9, or 3:2.
Fit	Cover (default) fills the frame and crops. Contain fits the whole image inside, leaving gaps.
Block ID	Optional anchor ID.

Autoplaying video is always muted

Browsers refuse to autoplay video with sound, so autoplay implies muted. Treat an autoplaying video as decorative motion, not as something carrying audio content.

The theme also respects the visitor’s “reduce motion” system setting: with that turned on, an autoplaying video stays paused. When controls are hidden, a small play/pause button is added so there’s always a way to stop the motion.

Aspect ratio and Fit work together

On Natural, the Fit setting has nothing to do — the frame matches the image. Pick any other ratio and Fit decides what happens to the mismatch: Cover crops, Contain letterboxes.

If faces or product labels are being cut off, either switch to Contain or crop the image properly before uploading. Cover always crops from the centre.

Tips

• Only add a mobile image when the crop genuinely differs. A wide landscape shot that becomes a narrow strip on a phone is the case for it; otherwise the main image is fine and it’s one less asset to maintain.
• Video files are heavy. Under 1MB is the target. A long or high-bitrate video will dominate the page’s load time.
• Write the alt text here if the image is used in more than one place with different meaning; otherwise set it once in the Files library.

Where it’s used

Text & Image Split, as a fixed block in the media column.