What is the Gallery block for?
Do not upload an archive. Edit a visual series. Gallery works best when related images tell something together: a project, place, event or collection. Selection and order matter just as much as the layout itself.
Gallery block
A good gallery is a selection, not an archive. Show fewer, stronger images rather than a long sequence that makes visitors search for the point themselves.
Which layout should you choose?
- Grid · 2 col: for larger images where details matter.
- Grid · 3 col: for a balanced general-purpose gallery.
- Grid · 4 col: for a fast visual overview.
- Masonry: for a natural rhythm of mixed aspect ratios.
- Horizontal scroll: for a longer continuous image sequence.
Lightbox viewing is useful when the images are worth opening at a larger size.
Order tells a story too
Start with a strong opening image, alternate wider views with details, and finish with a photograph that gives the sequence a sense of closure. That makes the gallery feel like an edited visual story rather than a simple image list.
Five gallery layouts in practice
The examples below show the same block in different layouts. Notice how the rhythm and visual weight of each photograph changes between 2-, 3- and 4-column grids, masonry and horizontal scrolling.
Grid · 2 col — for larger images
Grid · 3 col — for a balanced gallery
Grid · 4 col — for a quick overview
Masonry — for mixed aspect ratios
Horizontal scroll — for a longer image sequence
What can you configure in the Gallery block?
Layout, lightbox behaviour and per-image text work together to determine how the series can be browsed.
Five layouts
Choose a 2-, 3- or 4-column grid, masonry or horizontal scrolling.
Lightbox
When enabled, images can be opened at a larger size and browsed with the keyboard too.
ALT text
Describe briefly what is visible in each image. This matters for accessibility and also helps machines understand the visual.
Image TITLE
Optional extra title for an image. Avoid simply repeating the ALT text or caption.
Caption
Add visible context to an individual image when useful.
Order
Put the strongest image first, then let the rest follow in a deliberate visual rhythm.
When should you choose another block?
The key question is whether you want to feature one image at a time or show a whole series together.
A GOOD GALLERY EDITS
Show your strongest images in a deliberate order.
A consistent visual world, strong opening image and good rhythm matter more than the number of files you upload.