Artwork Gallery

Updated

Usage

The Artwork Gallery block shows works in a grid. Choose Columns, how links open (Page, Lightbox Page, or Lightbox Image), and whether works come from Handpicked selections, a By Category filter, or By Artist. Use Artwork Display to turn title, date, medium, and other details on or off.

When to use it

Use it as the main browsing grid on a collection or exhibition page. Pair with an Art Divider headline above the grid.

Tips

  • Set Artwork Selection first — Artworks, Categories, or Artist only appears for the matching mode.
  • Turn on Include Headline before you rely on the Headline field.
  • Show On View uses the Customizer Gallery Name when an artwork is marked on view.

Settings

Columns setting in the block editor sidebar
Columns

How many works sit in a row on wide screens.

  • 2
  • 3
  • 4default
  • 5
Artwork Selection setting in the block editor sidebar
Artwork Selection

How the gallery chooses which works to show. Set this before Artist, Categories, or Artworks appears.

  • Handpicked defaultYou pick specific artworks.
  • By CategoryAll published works in the categories you choose.
  • By ArtistAll published works linked to one artist.
Artist setting in the block editor sidebar
ArtistAvailable when Artwork Selection is “By Artist”

Artist whose works fill the gallery. Set Artwork Selection to By Artist first.

Categories setting in the block editor sidebar
CategoriesAvailable when Artwork Selection is “By Category”

Categories whose works fill the gallery. Set Artwork Selection to By Category first.

Artworks setting in the block editor sidebar
ArtworksAvailable when Artwork Selection is “Handpicked”

Works to show. Set Artwork Selection to Handpicked first.

Include Headline setting in the block editor sidebar
Include Headline

Shows a black rule and the Headline above the grid.

Headline setting in the block editor sidebar
Headline

Heading above the grid when Include Headline is on (default Artwork).

Artwork Display (group) setting in the block editor sidebar
Artwork Display (group)

Which details show under each work.

Show Title setting in the block editor sidebar
Show Title
Title Style setting in the block editor sidebar
Title Style

How the title looks. The heading level in the page outline stays the same.

  • h1
  • h2
  • h3
  • h4default
  • h5
  • h6
  • strong
  • p
Show Artists setting in the block editor sidebar
Show Artists

Shows linked artist names under the work.

Show Date setting in the block editor sidebar
Show Date
Show Medium setting in the block editor sidebar
Show Medium
Show Dimensions setting in the block editor sidebar
Show Dimensions
Show On View Location setting in the block editor sidebar
Show On View Location

Shows the on-view location text.

Show Description setting in the block editor sidebar
Show Description

Shows the artwork description under each work.

Show Credit setting in the block editor sidebar
Show Credit
Show On View setting in the block editor sidebar
Show On View

Shows the On View badge when the artwork is marked on view.