Collection

The Collection block puts a list of content on the page — events, posts, people, venues, and more — drawn straight from your content and shown as cards. Reach for it on landing and index pages: an upcoming-events listing, a blog feed, a company roster, a venue directory. Add it, choose what to list, and the cards stay current as you add or remove content.

Choosing what to list

Two controls sit at the top of the block.

Layout sets the shape of the listing: Grid (default), Scroller (a swipeable row), or Grouped. Grouped is only available when the listing is set to people; choose it for any other content type and the block falls back to a grid.

Collection chooses the content type to list: Posts, Events, People, Seasons, Series, Works, Venues, Organizations, Pages, or Blogs. Leave it blank to hand-pick a mixed list of items across types.

Content

The Content tab holds an optional Title shown above the listing and a Description shown beneath it.

Once you choose a content type, the Populate by option decides where the items come from:

• Collection (default) — list everything of the chosen type automatically.
• Manual Selection — pick specific items yourself in Select Items.
• Smart Collection — pull from a saved smart collection that targets the chosen type.

When the list is built automatically (the Collection or Smart Collection option), two extra controls appear: Sort By — Most Recent (default), Oldest, or A-Z — and Limit, the maximum number of items to display (default 10).

With the content type left blank, the Populate by, Sort By, and Limit controls do not appear; you hand-pick a mixed list directly in Select Items.

Some content types add their own controls:

• Posts, when listed automatically, can be narrowed by Blog, Authors, and Categories.
• Events offer a Hide past events toggle (on by default).

Hide when empty (off by default) removes the whole block from the page when the listing has nothing to show.

The View All Link group adds a link to the full listing. Turn on Show View All Link (off by default), set its Position — Top Right (default), Bottom Right, or Bottom Left — and choose where it points.

Grouped people

When the layout is Grouped and the listing is set to people, the Content tab changes. Source chooses between:

• Manual Groups — build named Participant Groups. Each group has a Group Name, a Show Images toggle, and a list of people, each with an optional Role / Title.
• Event Participants — pull the line-up from a single Event. Toggles let you Show Name, Show Role, Show Pronouns, Show Biography, and Show Image for each person.

Image Style sets the shape of the portraits: Portrait (default), Circle, or Square.

Cards

The Cards tab has one control: Card Pattern, the card design pulled from your theme. It defaults to the first design that matches the content type you're listing. Cards are configured in their own right — see Card for which details each card style can show.

Behaviour

Click Action sets what happens when a visitor clicks a card: Link (default, opens the item's own page) or Modal (opens it in a pop-up without leaving the page). The pop-up option is available for people, events, seasons, series, works, venues, and organizations.

In a grid layout, Enable Filters (off by default) adds a filter bar visitors can use to narrow the list. The available filters depend on the content type:

• Events — Venue Filter, Season Filter, Series Filter, Organization Filter.
• Posts — Blog Filter, Author Filter, Category Filter, Tag Filter.
• Organizations — Type Filter.

You can also filter by your own custom attributes: add each one under Custom Attribute Filters, with an optional Custom Label. Filter Section Label sets the heading shown beside the filters (for example, "Filter by").

Layout options

The grid and scroller each have their own placement controls, found on the block's layout settings (the Settings tab).

Shared controls

Beyond the options above, the Collection uses the standard block controls.

• Layout controls — set the container width and overall placement.
• Background and overlay — add a background behind the listing.
• Spacing and padding — adjust the margin and padding around the block.
• Colour scheme in blocks — set the colour scheme for the heading and cards.

Example

To build an upcoming-events page, add a Collection, set Layout to Grid, and set Collection to Events. Leave Populate by on Collection with Sort By set to Most Recent so the soonest events lead, and keep Hide past events on. Set Columns to 3. On the Behaviour tab, turn on Enable Filters and keep the Venue Filter and Season Filter so visitors can narrow the list. Add a Title of "What's on", then turn on Show View All Link, set its Position to Top Right, and point it at your full events page.

Where to go next