Media and decoration

Gallery

The Gallery block shows several images together, in a grid, in masonry columns, in justified rows or in a pattern of tiles. Clicking an image opens it full screen, and visitors move through the gallery's images there. You find it in the Media group of the block picker. It goes in a Section or a Post Content section, or inside a Group, a Collection, a No Results or a Paywall. The Gallery category of the pattern library has a ready section for each layout, with a heading above the images. The heading belongs to the section, not to the Gallery.

Gallery pattern titled Selected moments, with six pictures cropped to 4:3 in three columns, such as a forest trail and paintbrushes

Images

When you select a Gallery, the right sidebar starts with the Images group.

Setting What it does
Images The images, in the order they show. Click Add images to pick from your media library, upload, or search Unsplash. Drag an image to move it, or click it to change it or remove it. Each image is an Image block. Select it on the canvas for its own settings, such as its caption.
Click behavior Open lightbox (the default) opens a clicked image full screen over the page, in a lightbox where visitors browse only this gallery's images. None turns this off. A single image can override this with its own Click behavior, such as a link.

A new, empty gallery shows three choices on the canvas: Media library, Unsplash, or Blank for three empty frames you fill later.

General

Setting What it does
Layout How the images are arranged. See the table below. Grid is the default.
Pattern Shows with Tiles. The pattern of tiles that repeats over the images, with up to 6 columns and 24 tiles. Click a tile to resize it by its handles or drag it to move it. Point at the gap beside a tile to add one there. A tile you focus moves with the arrow keys, resizes with Shift and an arrow, and goes away with Delete. A tile's height counts in column widths, so a tile 1 column wide with a height of 0.5 is half as tall as it is wide.
Columns Shows with Grid and Masonry. How many columns, from 1 to 8, 3 by default. You can set a different number for tablets and phones. On a narrow screen a grid drops columns by itself, so that no image gets narrower than 128 px.
Image ratio Shows with Grid. The shape every image is cropped to: 1:1 (the default for a new Gallery, while the Grid pattern uses 4:3), 4:3, 3:2, 16:9, 3:4, 9:16 or Custom.
Row height Shows with Justified. How tall each row is, from 80 to 600 px, 240 px by default.
Layout What visitors see Use it for
Grid Rows of images of one shape and one size A tidy set, such as product shots or portraits
Masonry Columns of images that keep their own shape, each stacked under the one above Photos of many shapes
Justified Rows of one height that fill the width, each image keeping its shape A photo story that reads left to right
Tiles A repeating pattern of large and small tiles that you draw A magazine look with a few large images

Spacing

Setting What it does
Gap The space between the images. Click the link icon to set the space between columns and between rows apart.

The Spacing group's + menu also adds Padding and Margin.

Shared settings

The Gallery also has Width from the Layout settings, the Display settings and the Advanced settings. Add images and photos covers the image sources and size limits.

Was this article helpful?