Collections
A collection block lists entries. Its settings live on the block itself
(src/puck/CollectionPanel.tsx).
What it shows
Section titled “What it shows”- The latest of some types, filtered by category, tags and other taxonomies (
query.taxQuery) - Hand-picked entries (
query.include) - The page’s own listing, on archive, term and search pages
- Upcoming events only (
query.upcoming) - Random order (
query.orderBy: 'rand')
Display
Section titled “Display”- Grid, with desktop, tablet and phone columns
- List
- Slider
Card design
Section titled “Card design”Card designs come from the site’s cards (src/site/lib/content/cards.ts) and the core’s
(src/lib/content/card-presets.ts). Choosing one replaces the item template
(resolveCollection in src/puck/config.tsx); Custom keeps the blocks for hand-editing.
A Featured image block’s Height is Default, Auto (the image’s own height), a preset (Small
160px, Medium 240px, Large 320px, Extra large 420px) or Custom (any CSS length). In a card, Default
is Medium, cropped to fill the card’s width, so the cards in a row line up; an aspect ratio, a Fit
or Fill the card leaves the height to those instead. Outside a collection, Default is the image’s
own height (entryImageHeight, src/lib/content/image-height.ts).
Listed entries whose featured field is set get the is-featured class.
Pagination
Section titled “Pagination”Numbers, previous and next, or Load more: public/assets/js/collection-more.js fetches the next
page’s URL and appends that collection’s items.
An empty message shows when nothing matches.
Shuffle
Section titled “Shuffle”A shuffled collection (shuffle) renders part of a pool of up to 48 entries, and
public/assets/js/collection-shuffle.js picks a new random set on each visit, so cached pages still
vary.