Collections
Collection cards
Listing a collection's entries anywhere: one card you design repeats for each entry, ordered as you choose, with search, filters for visitors, pages and a loading state built in.
Adding collection cards
- Add Collection Cards from Basic Elements › Layout. It is a grid of three columns (one on phones) holding one Card.
- In its General tab, choose the Collection. (None yet? Make a page of the type Collection first, in the page manager.)
- Design the Card: it repeats for each published entry. It already links to {{item.url}} and shows {{item.slug}}; put {{item.title}}, an image with {{item.cover}} and anything else in it. Use these in the card lists every token.
- Publish the page. The canvas shows the search box, the filters and the pages, but they work on the website only.
Collection Cards settings
| Setting | Choices | What it does |
|---|---|---|
| Cards per page | 1–48 (9 to start) | How many cards each page of the list shows. |
| Name in the address | Up to 20 lower-case letters, digits and hyphens (items) | Searches read ?items-search=…, filters ?items.city=… and pages ?items-page=2. Give each list on a page its own name. |
| Order | Newest first, Oldest first, By a text, number or date field | Then Direction: A to Z or Z to A; Lowest or Highest first; Soonest or Latest first. Empty values go last. |
| Leave out entries whose date has passed | On or off (date fields) | Entries dated before today drop off by themselves; today's stay. |
| Put first | Nothing, or Entries with a True / False field on | Featured entries lead the list. |
| Show only (cards) | 0–48 (empty: all, with pages) | A strip: only that many cards, with no pages. |
Filters
- In the Filters settings, choose Add a filter and pick a field. Add up to six, and move them up or down: the website shows them in that order, above the cards.
- Give a filter a Label if the field's own name doesn't suit visitors (City becomes Town). Leave it empty to use the field's name.
- For a Text field, turn on Pick from the values entries hold: visitors choose from a list of the values your published entries have, instead of typing.
- Set the bar's words: Filter button (Apply), Clear link (Clear filters) and When nothing matches. Visitors choose, then press the Filter button, Search or Enter.
| Field type | Visitors choose | In the address |
|---|---|---|
| Text, Paragraph, Link | Words the value contains, in any case | ?items.about=jazz |
| Text, picking from values | One of the values entries hold, sorted (up to 50) | ?items.city=Paris |
| True / False | Yes, No or Any. An entry that leaves it empty counts as No. | ?items.open=true |
| Number | From and To, both included; either can stay empty | ?items.price.from=10&items.price.to=50 |
| Date | From and To days, both included, whatever the time | ?items.date.from=2026-06-01 |
| Image | Not offered: images can't be filtered | — |
Search, Pages & Loading
| Setting | Choices |
|---|---|
| Show a search box | On or off; Search hint (Search...), Search button (Search). |
| Pages | Previous and next, Page numbers, or No pages (the first ones only); the Previous and Next words. |
| Search and pages sit at | Start, Center or End. |
| While the cards load | Spinner over the cards, Bouncing dots over the cards, Bar along the top, Cards shimmer (skeleton), Cards fade, or Nothing; Loading text (also read to screen readers). |
| Buttons and loader color | Empty follows the text around the cards. |
| When there are no cards | Nothing here yet. |
| When a search finds nothing | Nothing matches "{search}". |
Which entries a visitor sees
- Published only
- Drafts, scheduled entries and an unpublished collection show nothing.
- Audiences
- Entries for some user groups show only to signed-in members of those groups, and only they see those entries' values among a filter's choices.
- Collection access
- A list shows nothing to a visitor the collection page itself isn't open to.
- Five lists
- Up to five collection cards lists on one page.
Worked examples
Worked example: Upcoming events, featured first
- Events collection with a Date field and a Featured True / False field.
- Collection Cards: Order By Date, Soonest first; Leave out entries whose date has passed; Put first Entries with Featured on.
- Cards per page 6, Pages Page numbers, While the cards load Cards shimmer.
Ideas to try
- A home-page strip: Newest first, Show only 3, no search box.
- Style the list with your own CSS: .siteho-cards-controls, .siteho-cards-search, .siteho-cards-filters, .siteho-cards-pager, .siteho-cards-loader, .siteho-cards-waiting.
- A venue finder: filters for City (picking from values), Open now (True / False) and Price (Number), with Clear filters to start over.
- A price-ordered product grid with a Countdown on cards for limited offers.