Calendar
List your events as an instance list, what's-on grid, day-schedule, or 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, a what's-on grid, a day-by-day schedule, or an alphabetical index.
Calendar pulls from your event listings. Set up your events first — see Create events — and the block 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.
Calendar Event List
A grid of cards for upcoming events — one card per event rather than one row per date.
Calendar 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.
- Background and overlay — add a background behind the block.
- Spacing and padding — adjust the margin and padding around the block.
- Colour scheme in blocks — set the colour scheme for the listing and filters.
Example
To build a what's-on page, add a Calendar and choose the Calendar 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, and turn off the filters you don't need. The listing then updates itself as you add and edit events.