Skip to main content
The EventList block renders a grid of event cards from the Sanity event document type. Events are fetched once per build by getAllEvents() and filtered by resolveBlockEvents() before the block receives them.

​
Props

​
heading
string
Optional section heading rendered as <h2>.
​
filterBy
'all' | 'upcoming' | 'past'
Controls which events are shown. Defaults to upcoming. Filtering logic runs in resolveBlockEvents() in sanity.ts.
ValueBehavior
upcomingEvents where status == "upcoming" or date >= now (sorted ascending)
pastEvents where status == "past" or date < now (sorted descending)
allAll events sorted by date ascending
​
limit
number
Maximum number of events to display. Defaults to 10.
​
events
SanityEvent[]
Pre-filtered array of event objects injected by BlockRenderer via resolveBlockEvents(). Each event includes _id, title, slug, date, endDate, location, description, eventType, status, isAllDay, and category.

​
Usage in Sanity Studio

  1. Add an Event List block to a page.
  2. Set an optional Heading.
  3. Choose a Filter: upcoming, past, or all.
  4. Set a Limit to cap the number of cards shown.
The status field on an event takes priority over date comparison. If an event’s date has passed but status is still upcoming, it remains in the upcoming list. Set status: past manually when the event is over.

​
Layout

Events render in a 3-column responsive grid (md:grid-cols-2 lg:grid-cols-3). Each card is rendered by EventCard.astro.

​
Example

{
  _type: 'eventList',
  heading: 'Upcoming Events',
  filterBy: 'upcoming',
  limit: 6
}