Calendar
List your events as an instance list, an events grid, a day schedule, or an A-Z index, with a shared filter panel.
The Calendar block lists your events on the page and lets readers narrow them with a filter panel. Pick the format that fits the page: a running list of dates, an events grid, a day-by-day schedule, or an alphabetical index.
Calendar uses your event listings. Before you add this block, create your events. See Create events. The block then lists them automatically.
Choosing the format
Pick the format at the top of the block. Instance List is the default. Whichever you pick, set the Heading shown above the listing.
Instance List
A running list of individual event dates and times.
Event List
A grid of cards for upcoming events: one card per event rather than one row per date.
Screening
A day-by-day schedule grid, useful for cinema-style programming where several showings share a day. Three extra controls set the shape of the grid:
- Day Start Hour: the first hour shown on the schedule, from 0 to 23. Starts at 9.
- Day End Hour: the last hour shown, from 1 to 24. Starts at 23.
- Slot Minutes: how finely the day is divided, from 15 to 180 minutes per slot. Starts at 60.
A-Z
An alphabetical index of events.
Filters
The Filters tab controls the panel readers use to narrow the listing. Every format shares the same set.
The filter panel sits in a sidebar, which becomes a slide-out drawer on smaller screens.
These toggles each add a filter to the panel, and all are on by default:
- Event Filter: filter by event.
- Text Search: a search box for matching by name.
- Date Filter: filter by date.
- Series Filter: filter by series.
- Venues Filter: filter by venue.
Under Custom Attribute Filters you can add your own filters built from your custom attributes. For each one, set the Custom Attribute to filter by, and optionally a Custom Attribute Label to rename it in the panel. Only attributes that present a fixed set of choices or link to other content can be used as a filter.
Shared controls
Beyond the options above, the Calendar uses the standard block controls.
- Layout controls: set the container width (a narrow width is available) and overall placement.
- Spacing and padding: adjust the margin and padding around the block.
- Colour scheme in blocks: set the color scheme for the listing and filters.
Example
To build an events listings page, add a Calendar and choose the Event List format. Set the Heading to something like What's On. On the Filters tab, keep Text Search and Venues Filter on so readers can search by name or narrow to a single venue. Turn off the filters you do not need. The listing then updates itself as you add and edit events.