Last updated July 11, 2026, Version 0.34
GatherPress includes a block-variation of the core/query block, called Event Query. This block allows for everything a normal query block can do including the following:
- Allows endless customization in terms of layout & style, incl. the use of interactive blocks.
- Allows editors to drop in the Event Card with RSVP starter pattern (featured image, date, title, venue, online event link, RSVP responses, and RSVP button) via the block’s Choose button or the Replace button in the top toolbar.
- Allows editors to start with a minimal event scaffold via the Start blank button and the underlying Block Variation Picker — whichever scaffold the editor picks, the post template is seeded with
Event Date+ a linked post title rather than WordPress’s generic post-date layout. - Allows to query either past or upcoming events.
- Allows to select for the inclusion or exclusion of started, but not yet finished, events.
- If used within a
gatherpress_eventpost, an editor can choose to “Exclude (the) current Event” - Allows for custom ordering (
ORDER BY) of the events by:- datetime (default)
- random
- title
- post_id
- last modified date
- … in either ASC or DESC
ORDER - Allows to filter the queried events by Author, Keyword, Topic or Venue (and any other additionally registered taxonomies).
- Filter by current venue toggle — when placed on a venue page, the query is automatically scoped to that venue’s events. The toggle is hidden on regular posts where there’s no venue context to use. In templates or template parts, the toggle is shown with a note that the filter only takes effect when the template renders on a venue page.
- The variation is automatically loaded, when an editor chooses the „Event“ post type in a regular
core/queryblock.