Media

The Media block puts one image or one video on the page. Use it for a standalone photo, an illustration, or a single video — anywhere a block of running text or a multi-image layout would be too much. For several images side by side, use a Gallery or Carousel instead.

At the top of the block, Variant sets what you are adding: Image (default) or Video. The fields below change to match your choice. A Heading field sits above both — add optional text to show alongside the media, or leave it blank.

Image

Choose Image as the Variant, then set the picture and how it appears.

• Image — choose an existing image or upload a new one. Once an image is selected, a Fit option appears: Cover (default) fills the frame and crops the overflow, Contain shows the whole image inside the frame, and Fill stretches it to the frame's exact shape (separate from the Width: Fill option on the Size tab). You can also point the image at a link so the whole picture is clickable.
• Show Caption — on by default. Shows the caption saved with the image.
• Show Credit — on by default. Shows the credit saved with the image.

Video

Choose Video as the Variant, then pick where the video comes from with Source: Uploaded (default) or External URL.

Uploaded video

With Source set to Uploaded, the Video field lets you choose or upload a video file. Once a video is selected, four playback options appear:

• Autoplay — on by default. Starts the video automatically.
• Loop — on by default. Restarts the video when it ends.
• Muted — on by default. While Autoplay is on, the video stays muted and this cannot be turned off — browsers block sound on videos that play on their own.
• Controls — off by default. Turn it on to show play, pause, and volume controls.

External video

With Source set to External URL, paste the address instead of uploading a file:

• Video URL — paste a YouTube, Vimeo, or other embeddable video address.
• Title — an accessible title for the embedded video, used by screen readers.
• Thumbnail Only — off by default. When on, the block shows a clickable thumbnail and only loads the full video once a visitor presses play; the title and controls stay hidden until then.

Sizing and frame

The Size tab controls how large the media is and the shape of its frame.

• Width — Fit, Fill (default), or Custom. Choosing Custom reveals a slider measured as a percentage of the available space.
• Mobile Width — the same choices for phones, also Fill by default.
• Aspect Ratio — the shape of the frame: Auto (default), 1:1, 4:3, 16:9, 3:2, 2:3, 3:4, or 9:16. Combine this with Fit above to crop a tall photo into a wide banner, or the reverse.

Borders and corner radius live on the Appearance tab, alongside the block's colour controls. Corner Radius offers None (default), Theme, or Custom — the slider for rounding the edges appears once you pick Custom. Borders is None or Solid, with a Border Position (Top, Bottom, or All) and a Border Color when set to Solid.

Shared controls

The Media block uses the standard block controls for spacing and colour. It has no layout row of its own — control its width from the Size tab above.

• Spacing and padding — adjust the padding (including horizontal spacing) and margin around the media. Top and bottom padding start at zero.
• Colour scheme in blocks — set the colour scheme, plus borders and corner radius on the Appearance tab.
• Analytics keys — tag the media for reporting, useful when the image links somewhere.

Example

To drop a wide hero photo into a page: add a Media block, leave Variant on Image, and choose your photo. Set Fit to Cover and Aspect Ratio to 16:9 so the picture crops to a clean banner shape, leave Width on Fill to span the column, and turn off Show Caption and Show Credit for a clean look. On the Appearance tab, set Corner Radius to Custom and drag the slider to round the edges.

Where to go next