Basker Docs

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 automaticallyCollection
Change what each listed item shows or how its card looksCard
Scroll records in a swipeable rowCollection (Scroller layout)
Spotlight a hand-picked few records as a carouselFeatured
Show events on a date-based view with filtersCalendar
Build the header at the top of an event, person, or venue pageMasthead
List an event's performance dates with booking buttonsEvent Instances
Show an event's venue, address, and an info linkVenue

Event Instances and Venue appear in the block list only while you are building an event page. See Create events.

Where to go next

On this page