Back to Help

Image galleries

August 3, 2026

Build reusable, named image galleries with five display styles and an optional lightbox, then drop them into a page block or a sidebar widget.


A gallery is a named, reusable set of images — managed once from the channel dashboard, then dropped into any page (as a block) or any sidebar/footer (as a widget) by reference. Edit the gallery once and every place it's used updates.

Creating a gallery

Open Galleries from the channel dashboard. Create one, name it, and add images from the media library or by uploading new ones directly. Each image needs:

  • Alt text — required, for accessibility.
  • Caption — optional.

Drag to reorder. Delete a gallery and anything still referencing it shows an empty placeholder instead of breaking.

Using it in a page

Add a Gallery block (see page blocks) and pick the gallery. Choose a display style:

  • Grid — the default, a responsive 3-up row.
  • Masonry — a Pinterest-style column layout; images keep their natural aspect ratio.
  • Slider — a carousel, one image at a time.
  • Thumbnails — small, uniform, bordered thumbnails in a row.
  • Cover — a square-cropped uniform grid (4 columns desktop, 3 tablet, 2 phone).

Turn on Lightbox to make every thumbnail open a full-size carousel modal on click (arrow-key navigable). Not available in Slider mode, since the slider is already the browsing view.

Using it in a widget

Add the Gallery widget to a sidebar or footer widget area and pick a gallery. Widgets always render as a simple vertical stack with captions — the five page-block display styles are page-block only.

Linking to the source image

An image added from the media library can carry a link back to that asset's detail page. When present, clicking the image (outside the lightbox) opens that page instead of just the raw image file.

MCP shortcut

If you connect an MCP client, list_galleries, get_gallery, create_gallery, update_gallery, and delete_gallery let you author and maintain galleries conversationally — the same operations as the dashboard.

media gallery images page-blocks widgets