Skip to main content

Image block

What is the Image block for?

When the image itself carries the message, give it room of its own. The Image block highlights one visual as a standalone content point. Use it for a reference, product photo, location, portrait or detail that does not need a long explanation beside it.

You are not only choosing a picture: aspect ratio, width, focal point and caption work together to determine how the image reads on the page.

A craftswoman carving a pattern into a wooden bowl with a chisel in a workshop.
Wide 16:9 — a strong default for places, processes or horizontal compositions.

The focal point matters when an image is cropped. Changing the aspect ratio can cut off part of the photograph. In the editor, mark the point that must remain visible — for example a face, product or important detail.

ALT text, captions and decorative images

ALT text describes the essential meaning of an image for someone who cannot see it. A caption adds visible context for every visitor. Image TITLE text is optional and usually does not need to repeat the same information.

If an image is purely decorative, mark it as decorative in the editor instead of forcing a meaningless description into the ALT field.

What can you configure in the Image block?

From aspect ratio and focal point to accessible description, each important detail can be controlled separately.

Five image modes

Wide 16:9, Tall 4:5, Square 1:1, Full width or Original size. Full width also uses 16:9 but removes the image's own width limit; Original size preserves the source aspect ratio.

Focal point

Choose which part of the image stays central when the crop changes between aspect ratios.

ALT or decorative

Describe meaningful images briefly; mark purely decorative images as decorative.

Caption and TITLE

A caption provides visible context. TITLE text is optional and does not replace ALT text.

Background and width

Block background, section width and content width determine how much visual space the image receives.

Visibility and scheduling

Limit the block by device or time window, and adjust the space around it separately.

New setting: Shape

Cuts the picture to a shape that unveils like a curtain as it scrolls into view.

Arch

A cut-out rounded at the top, like an archway.

Circle

The largest circle the frame holds, centred.

Blob (slowly morphing)

A soft, irregular shape that slowly changes its outline.

Good to know

Needs a cropped frame (Fill). Printed pages show the picture uncut.

A potter's hands shaping clay while working.
Blob shape on a square, filled frame: the picture gets a soft outline that slowly changes.

Image modes in practice

After the wide example above, here are three more ways the same block can behave. They are not simply different-shaped frames: each gives the visual a different weight in the page structure. The fifth option, Original size, does not crop the image at all and keeps its original proportions.

A woodworker working on timber in a workshop.
Tall 4:5 — useful for people, portraits and vertical subjects. The block is narrower, so it does not dominate the whole page.
A potter's hands shaping clay while working.
Square 1:1 — useful for detail photography, products and centred compositions.
A bright, spacious workshop with a large wooden worktable.
Full width — works well for a strong wide image that can carry attention as a section in its own right.

GIVE A STRONG VISUAL ROOM

One image can be a complete content moment.

Choose an aspect ratio that suits the subject, set the focal point and write ALT text that genuinely describes the image.