Add a photo gallery

Show your photos in a neat grid, picked by you or taken from the photos of each row in a table.

Updated 17 Nov 2026

The Gallery block shows your photos in a grid. Use it for a portfolio, the photos of a trip or a room, or a set of product shots. You pick the photos from your media library, or let a table fill the grid with each row's photos. The block does the layout, and the grid shrinks to fewer columns on a phone.

Add a gallery

  1. Open your site in the editor and open the page you want.
  2. Click the add (plus) button to open the block menu, then pick Gallery in the Media group. You can also type "gallery" or "grid" in the search box at the top of the menu.
  3. Click Browse library on the new block.
  4. Tick one photo or several, then confirm. Every photo you picked is added in one go.

A gallery with no photos shows a placeholder in the editor and nothing on your published page, so an empty one never leaves a gap.

Add, reorder and remove photos

Select the gallery and look at the photo list in the settings panel. Under Photos come from, keep Picked by you.

  • Add photos opens your media library. You can pick several at once. While the gallery is selected, an Add photos button also sits on the block itself.
  • Reorder: drag a photo by its handle, or focus the handle and use the keyboard.
  • Remove photo: the bin button on a row. Undo brings it back.

Columns

  • Columns, desktop can be 2, 3 or 4.
  • Columns, phone can be 1 or 2.

Photo shape and fit

Photo shape gives every photo the same proportions: Square 1:1, Landscape 4:3, Landscape 3:2, Wide 16:9, Portrait 3:4, or As uploaded, which keeps each photo's own shape.

Fit decides what happens when a photo does not match the shape. Cover fills the space and trims the edges. Contain shows the whole photo with some empty space around it. Fit is switched off while the shape is As uploaded.

Gap and rounded corners

Gap sets the space between photos: None, S, M or L. Rounded corners can be None, Small or Large.

Show each row's photos from a table

If you have a table with a photo field that holds several photos, such as a trip with many pictures, the gallery can show each row's photos on that row's page.

  1. Open the page design for the table, the page that is shown once for each row.
  2. Add a Gallery to that page and select it.
  3. Under Photos come from, choose From a table.
  4. In Table field, pick the photo field.

The grid then fills with the photos of whichever row the visitor is looking at. Switching back to Picked by you keeps the photos you picked earlier, so nothing is lost. If the page has no table behind it, the panel tells you so.

Common questions

How do I change the description of a photo? Click the photo on the page, and the photo's settings open. Type a short sentence in the description box. Visitors who cannot see the photo hear it, and search engines use it.

Can visitors open a photo full screen? Not in this block. If you want a bigger view, give the photo a link to the full-size image.

Should I use the Photo carousel instead? Use the Photo carousel when you want photos to slide, with arrows, dots or automatic movement. Use the Gallery when you want them all in view at once, in a grid.

What shows if a row has no photos? Nothing. The gallery is left out of that row's page, so there is no empty space.

More in this topic

Back to Help centre

Still stuck?

Write to us and a person replies.

Email [email protected]