Collection page overview
Block-based collection layout — header, image, description, listing.
Updated 2026-05-09
Collection page is fully block-based. Every visual element (title, image, description, product grid) is a separate block under the Customize → Collection section.
Available blocks
| Block | Purpose |
|---|---|
| Title & breadcrumbs | Collection title, breadcrumbs, sub-category pills |
| Image | Hero image (collection's image or custom upload) |
| Description | Rich text description with show more / less |
| Product listing | The actual grid + filters + sort + pagination |
You can reorder blocks freely. The most common arrangement is Title → Image → Description → Listing.
Behavior
- Each block has its own padding and container width (boxed / full).
- Blocks render only if they have content (e.g., Image hides if no image is uploaded and the collection has no default image).
- Title block can show breadcrumbs and sub-category pills via metafield or linked menu.
Sub-category pills
The Title block can render filter pills that filter the current collection by tag. Source the labels from:
custom.subcategoriesmetafield (List of single-line text) → fastest setup, scoped per collection- A linked-list with the same handle as the collection
Pills rendered as: [ All ] [ Subcat 1 ] [ Subcat 2 ] ...
Clicking a pill applies a ?filter=... URL parameter and the listing block applies the filter.
Need a hand? Contact support.