Artwork Gallery

Artwork Gallery showing a grid of paintings with titles and dates.
Artwork Gallery grid with titles, dates, and mediums.

Usage

The Artwork Gallery block lists works in a responsive 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 catalog fields print under each work in the grid.

Show Title setting in the block editor sidebar
Show Title

Shows the artwork title under the image.

Title Style setting in the block editor sidebar
Title Style

Visual style for the title. This does not change the underlying heading level.

  • 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

Shows the artwork date.

Show Medium setting in the block editor sidebar
Show Medium

Shows the medium line.

Show Dimensions setting in the block editor sidebar
Show Dimensions

Shows 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 the grid item.

Show Credit setting in the block editor sidebar
Show Credit

Shows the credit line.

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

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