Collections and cards
How the Collection, Card, Featured, Calendar, Masthead, and event blocks fit together, and which one to reach for.
These blocks pull your own content — events, posts, people, venues, and more — onto a page, so a listing or a header stays current as you add and edit that content. They divide into two jobs: blocks that list many records, and the header that sits on a single record's page.
The piece they share is the Card — the repeated unit that holds one record's title, image, and supporting details. A Collection or Featured block decides which records appear and how the listing is arranged; the Card decides what each item shows and how it looks. You don't add a Card to a page on its own — you edit the card inside the block that holds it.
How they relate
- Collection lists records automatically. Pick a content type and it shows everything of that type as cards, staying in sync as content changes. It can also list a hand-picked or rule-based set, and add filters readers use to narrow the list.
- Card is the repeated unit inside a Collection or Featured block. Its Type decides which details it can hold — an event card carries a date and venue, a person card a role and pronouns — and its layout controls how each item looks.
- Featured spotlights a hand-picked set of records as a full-width carousel, one slide per record, with per-slide overrides. Reach for it to highlight a curated few rather than an auto-generated list.
- Calendar shows your events in date-based formats — a running list of dates, a what's-on grid, a day-by-day schedule, or an A-Z index — with a shared filter panel.
- Masthead is the large header at the top of a single record's page. It matches the kind of page it sits on and is built from that page's own details.
- Event Instances and Venue add event detail below a Masthead — the performance dates with booking buttons, and where the event takes place.
Which one should I use?
| You want to… | Use |
|---|---|
| List content by type and keep it current automatically | Collection |
| Change what each listed item shows or how its card looks | Card |
| Scroll records in a swipeable row | Collection (Scroller layout) |
| Spotlight a hand-picked few records as a carousel | Featured |
| Show events on a date-based view with filters | Calendar |
| Build the header at the top of an event, person, or venue page | Masthead |
| List an event's performance dates with booking buttons | Event Instances |
| Show an event's venue, address, and an info link | Venue |
Event Instances and Venue appear in the block list only while you are building an event page. See Create events.
Where to go next
Collection
List events, posts, people, and more as cards that stay current.
Card
Set what each listed item shows and how its card is laid out.
Featured
Spotlight a hand-picked set of records in a full-width carousel.
Calendar
Show your events in date-based views with a shared filter panel.
Masthead
Build the large header at the top of a single record's page.
Event Instances
List an event's performance dates and times with booking buttons.
Venue
Show where an event takes place, with an address and an info link.
Building pages with blocks
Add, arrange, and remove blocks like these on a page.