Skip to main content

Event list block

What is the Event list block for?

A useful event list should handle the passage of time for you. The Event list block can show several events automatically or from a manual selection. In automatic mode, choose Upcoming, Past or All events. In manual mode, you decide exactly which events stay in the list and in what order.

That means the same block can power an upcoming-events section, an archive or a deliberately curated programme.

Example: upcoming and past events

The two lists below both use automatic mode. The first shows upcoming events in a grid ordered by start time. The second shows past events in a list with the most recent first. When an event passes, it automatically moves from the first group to the second. The example events are fictional and exist only for the Help Center.

The time window is the first decision. In automatic mode, an upcoming list normally shows future events while an archive shows past ones. In manual mode, selected events stay in place even after they have passed. If an automatic filter returns no results, the block simply stays hidden on the public page rather than showing an empty container.

Choose the time logic first

The right mode and time window matter more than whether the content appears as a grid or a list.

Upcoming

An automatic list of future events. Useful for programme sections, usually ordered from the nearest date onwards.

Past

An automatic archive of completed events. Useful for references, recaps or browsing previous programmes.

All

Can include past, future and undated events together. Useful when time filtering is not the main organising principle.

Manual selection

Choose the exact events and their order yourself. Selected past events remain in the list.

By day: the programme day by day

The By day layout groups events by day, so visitors see at a glance what is on today, tomorrow or at the weekend. Events on the same day are listed by start time. Use Day view to choose one of three forms:

  • Days with their date pinned: each day is a section, and its date stays beside it while that day's events scroll. Good for a longer programme.
  • Day cards to pick from: cards for the days at the top, with the selected day's events below. Ideal for a festival or a multi-day event.
  • Timeline: the days hang off a vertical line. Good when the programme reads as a sequence.

Live example: day cards

Pick a day from the cards to see that day's events below. Wednesday has two.

Event list by day: for each day, the weekday and date on the left, and beside it that day's events with start time, title, category and venue.
Days with their date pinned.
Event list with day cards to pick from: seven day cards from Monday to Sunday at the top, the first one selected, and the selected day's event below.
Day cards to pick from.
Event list in the Timeline view: a vertical line on the left with a dot for each day and its full date, and that day's events listed below with their start times.
Timeline.
Event list settings: By day is selected among the layout buttons, and the Day view dropdown below is set to “Day cards to pick from”.
Day view appears once the By day layout is selected.

The same options as the News list

The Event list offers the News list's layouts and list settings too:

  • Featured + grid: one event gets a large card, the rest sit in a grid beside it.
  • Mosaic: image tiles of mixed sizes, in the Magazine, Alternating or Bento view.
  • Let visitors filter by category: category chips above the list, when the events come from at least two categories.
  • Shown at first: this many events show first; the More button brings in the rest.
  • On a phone, a row swiped sideways: in the Grid layout, a row swiped sideways on phones instead of one long column.

The News list block's help article describes these settings in detail, with screenshots.

The time window determines whether past events disappear automatically. Decide that first, then choose the layout, card details and button copy.

TIME IS A FILTER TOO

Show upcoming events automatically and keep archives intentional.

If you only want to feature one specific event, the Chosen event block is the simpler, more stable choice.