Canvas Docs

Event Archive Grid

Events grid for the main query (archive + category). Uses the event-entry-grid partial + shared pagination. It is shown in the block inserter as Event Archive Grid and registered as canvas-core/event-archive.

Select the block on a page and its own settings open in the sidebar, in the panels below:

The Event Archive Grid settings in the block editor sidebar

Settings

Each setting is named exactly as the block editor names it, followed by what it does and what it starts as. Where a setting carries a Shown when line, it stays hidden until that condition is met, which is the usual reason a setting looks missing from the sidebar:

Layout

  • LayoutDefaultGrid (stacked cards)

    How the events are arranged: stacked cards side by side, or full width rows with the picture beside the detail.

    ChoicesGrid (stacked cards)List (horizontal rows)

  • ColumnsDefault0

    How many cards sit across a row on a wide screen. Leave it at 0 to follow the layout default.

    Shown when Layout is "Grid (stacked cards)"

  • Feature First EventDefaultOn

    Render the first event as a full-width horizontal card above the grid.

    Shown when Layout is "Grid (stacked cards)"

  • Show PaginationDefaultOn

    Shows the controls that move between pages of events under the list.

  • Pagination StyleDefaultEmpty

    How those controls are drawn. Theme Options follows the choice made site wide, so every archive matches.

    ChoicesTheme Options (empty)Older / Newer buttonsNumbered circlesShown when Show Pagination is on

  • Older Button LabelDefaultOlder

    Wording on the button that moves towards older events.

    Shown when Pagination Style is "Theme Options" or "Older / Newer buttons"

  • Newer Button LabelDefaultNewer

    Wording on the button that moves back towards newer events.

    Shown when Pagination Style is "Theme Options" or "Older / Newer buttons"

Content

  • Show ImageDefaultOn

    Shows the featured image of each event on its card.

  • Show Type BadgeDefaultOn

    Shows the event type as a small tag over the picture.

    Shown when Show Image is on

  • Show DateDefaultOn

    Shows when each event takes place, in the formats set below.

  • Show ExcerptDefaultOn

    Shows a short summary of each event under its title.

  • Show LocationDefaultOn

    Shows where each event is being held.

  • Card Date FormatDefaultD, M j

    PHP date format for the card date line, e.g. "D, M j" renders "Fri, Jan 23".

    Shown when Show Date is on

  • Card Time FormatDefaultg:iA

    PHP time format appended after "@", e.g. "g:iA" renders "5:30PM".

    Shown when Show Date is on

  • Card Image RatioDefaultEmpty

    Proportions every card image is cropped to, for example 16/9, so pictures of different shapes line up. Empty keeps their natural shape.

    Shown when Show Image is on

  • No Events MessageDefaultNo events found.

    Shown in place of the list when there are no events to show, so the page never looks broken.

Every Canvas block also carries the Animation, Scroll Effects and Advanced panels, which are described in Controls every Canvas block has.

Other blocks in Events: Conference Programme, Event Categories, Event Content, Event Date, Event Excerpt, Event Image.

Was this page helpful?