Editing

Galleries are edited where they live: in the block editor, with the real layout, real categories and real filters. These are the tools that make that quick.

Edit and Preview

The gallery’s toolbar has two modes:

  • Edit shows any layout as a plain grid of whole photos in their order. Each photo carries a badge with its categories (“No category” in yellow), and an Add images tile sits at the end.
  • Preview is the real layout, exactly as visitors see it.

Masonry, rows and grid open in Preview. Carousel and accordion open in Edit, because their real layout hides or crops photos. The mode only exists in the editor and is never saved.

Filter preview

Click a Gallery Filter button in the editor and the galleries in Preview mode filter right there. Use it to check the categories before you publish. Nothing is saved.

Categories for several images at once

  1. Select one image in the gallery, then shift-click more.
  2. Click the tag button in the block toolbar.
  3. Tick or untick categories. A checkbox shows as mixed when only some of the selected images have that category. Create new categories right in the menu.

Changes are saved to the images in the Media Library at once, so they apply in every gallery that uses those images. A single image also has the Gallery categories panel in the sidebar.

Sort

The gallery toolbar sorts the images: newest or oldest first, title A–Z or Z–A, file name, reverse, or shuffle. Posts and media queries inside the gallery keep their places.

Add content

The Add images button and the Add content menu in the gallery toolbar – and the empty gallery – add images (several at once from the Media Library), posts or pages (a posts query; each item links to its page) and a media query.

Transforms

Under block toolbar → Transform to:

FromToNotes
Core GalleryFilterable GalleryImages keep captions and links. Cropped galleries become a grid, uncropped ones masonry. Core’s image lightbox turns the gallery lightbox on.
Several selected Image blocksFilterable Gallery
Query LoopFilterable Gallery
Filterable GalleryCore GalleryWhen it holds only images
Filterable GalleryUngroupLeaves the inner blocks

Commands

Press Cmd+K (Ctrl+K) in the editor to open the command palette:

CommandWhat it does
Add filterable galleryInserts a Gallery Filter and a Filterable Gallery that are already connected
Edit all galleriesSwitches every gallery on the page to Edit
Preview all galleriesSwitches every gallery on the page to Preview
Tag selected imagesOpens the categories menu for the selected images; shown only while images in a gallery are selected

Motion in the editor

Scroll reveal plays in Preview mode, so you can tune the effect and its stagger while you edit. Autoplay and hover effects are turned off in the editor, so the canvas stays calm; they run on the front end and in the post preview.

The Filterable Gallery, Gallery Filter, Gallery Media Query and Gallery Posts blocks share one icon family – tiles with a turquoise mark – so they are easy to spot in the inserter, toolbar and list view.