Collection Page
The collection page displays the products in a collection as a configurable grid, with faceted filtering, sorting, four pagination styles, and fully customizable product cards. This guide also covers the Collections list page (the landing page that shows all your collections) and the global theme settings that affect both.
Table of contents
- SEO & grid layout - Filters & sorting - Desktop & mobile layout (spacing) - Colors - Product card content blocks - Promo tile block
- Pagination - Filter & sort design - Product card (global styling)
Before you start
From your Shopify admin go to Online Store → Themes → Customize.
- Collection grid: open the template picker → choose Collection pages → select the Collection section.
- Collections list: open the template picker → choose Collections list.
Important
The collection template ships with no built-in banner/hero. The collection's title, description, and image are not shown automatically — they're included only as hidden SEO data (controlled by Enable Collection schema). To display a visible collection title or banner, add a section manually (e.g. an image banner or rich text) above the Collection section.
Part 1 — Collection product grid
Select the Collection section in the Collection pages template.
SEO & grid layout
| Setting | What it does | Options / Range | Default |
|---|---|---|---|
| **Enable Collection schema (JSON-LD)** | Outputs CollectionPage and ItemList structured data for SEO | On / Off | On |
| **Products per page** | How many products load per page | 8–48, step 4 | 16 |
| **Loading type** | How additional products load | Pagination (page refresh) / Pagination (AJAX) / Load more button / Infinite scroll | Pagination (page refresh) |
| **Columns on desktop** | Products per row on desktop | 1–6 | 4 |
| **Columns on tablet** | Products per row on tablet | 1–4 | 3 |
| **Columns (mobile)** | Products per row on mobile | 1 Column / 2 Columns | 2 |
| **Enable layout switcher** | Show column-count buttons above the grid so shoppers can change products per row | On / Off | On |
Filters & sorting
These controls are shared with the search results page — styling choices carry across both.
| Setting | What it does | Options | Default |
|---|---|---|---|
| **Enable filtering** | Show filters on the collection | On / Off | On |
| **Show only color (hide swatch label)** | Color swatch filters show only the swatch circle (label still read by screen readers). Only when filtering is on | On / Off | Off |
| **Desktop filter placement** | Where filters appear on desktop | Left sidebar / Collapsible left sidebar / Right sidebar / Above products / Drawer / Modal / None | Left sidebar |
| **Enable desktop sorting** | Show a sort control on desktop | On / Off | On |
| **Desktop sort position** | Where the desktop sort control sits | Toolbar / With filters | Toolbar |
| **Mobile filter style** | How filters open on mobile | Drawer / Modal | Drawer |
| **Enable mobile sorting** | Show a sort control on mobile | On / Off | On |
| **Mobile sort position** | Where the mobile sort control sits | Toolbar / With filters | Toolbar |
| **Pill border radius** | Roundness of active-filter chips | Default / Rounded / Medium / Large / Full rounded | Default |
Note
The filters themselves (price, color, size, availability, etc.) are created in Shopify admin under Settings → Search & Discovery → Filters. These settings only control placement and styling.
Desktop & mobile layout (spacing)
Desktop layout
| Setting | Range | Default |
|---|---|---|
| **Padding top** | 0–200 px, step 2 | 60 px |
| **Padding bottom** | 0–200 px, step 2 | 60 px |
| **Gap** (grid spacing) | 0–35 px | 24 px |
Mobile layout
| Setting | Range | Default |
|---|---|---|
| **Padding top** | 0–100 px | 40 px |
| **Padding bottom** | 0–100 px | 40 px |
| **Gap** (grid spacing) | 0–20 px | 16 px |
Colors
Set under Colors (light mode) and Colors (dark mode), organized by surface. Leave blank to inherit the theme.
| Surface | Settings |
|---|---|
| **Section (primary)** | Background color, Text color, Border color |
| **Drawer & modal** (when filtering is on) | Background color, Text color, Border color |
| **Sort dropdown** (when sorting is on) | Background color, Border color, Text color, Active color, Active text color, Hover color, Hover text color |
| **Filter pill** (when filtering is on) | Background color, Text color |
Product card content blocks
The product card is built from content blocks you can add, remove, and drag to reorder on each card. Each block controls one piece of card content.
The card's overall look (image ratio, hover effect, borders, add-to-cart placement, card colors) comes from the global Product card theme settings — see Part 3. The blocks below control which text/content appears on the card and its typography.
| Block | What it shows | Limit | Key settings |
|---|---|---|---|
| **Vendor** | Product brand/vendor | 1 | Vendor size (Small/Medium/Large), Font weight, Text transform (uppercase), Vendor opacity (50–100%) |
| **Title** | Product name | 1 | Title size, Title weight, Uppercase title |
| **Price** | Price, compare-at, and unit price | 1 | Size/weight/transform for each of Price, Compare-at, Unit price; light/dark colors; Show "from" price; Show compare-at price |
| **Product options** | Variant options/swatches on the card | 1 | Size, Font weight, Text transform |
| **Add to cart** | Quick add-to-cart control | 1 | — (no settings; styled globally) |
| **Description** | Short product description | 1 | Maximum lines (1–5, default 2) |
| **SKU** | Product SKU | 1 | — |
| **Rating** | Product review rating (requires a reviews app) | 1 | — |
| **Inventory status** | Stock indicator | 1 | — |
| **Custom text** | Custom text or a metafield value (e.g. a badge) | 3 | Text source (Metafield / Custom), Metafield `namespace.key`, Custom text |
Price block detail
The Price block has the most options:
- Price / Compare-at price / Unit price — each has Size (Small/Medium/Large), Font weight (Normal/Medium/Semibold/Bold), and Text transform (Normal/Lowercase/Uppercase).
- Colors (light mode) — Price color, Sale price color, Unit price color.
- Colors (dark mode) — Price color, Sale price color, Unit price color.
- Show "from" price (default off) — prefix the price with "from" for products with multiple variants.
- Show compare-at price (default on) — show the original (struck-through) price on sale items.
Note
This section has no presets — it's the dedicated collection template section and can't be added elsewhere as a generic section.
Promo tile block
A Promo tile is a promotional card you drop inside the product grid — it appears after the Nth product card (configurable), spanning one or more columns. Use it for a sale banner, a category callout, or an editorial block woven into the products.
Add it like any other block in the Collection section (Add block → Promo tile). Unlike the card content blocks, the promo tile has no limit, so you can add several and place each at a different position.
The tile is position-aware: if a shopper uses the layout switcher to change the number of columns, the tile re-aligns to a clean row so the grid never looks broken.
| Group | Setting | What it does | Options / Range | Default |
|---|---|---|---|---|
| **Position** | Desktop position | Insert the tile *after* this product number on desktop | 1–50 | 4 |
| Mobile position | Insert the tile *after* this product number on mobile | 1–50 | 2 | |
| **Width & height** | Desktop width | Columns the tile spans on desktop | One / 2 / Three / Four column / Full width | 2 column |
| Mobile width | Columns the tile spans on mobile | One / 2 column / Full width | Full width | |
| Desktop height | Minimum tile height on desktop | 200–800 px, step 10 | 420 px | |
| Mobile height | Minimum tile height on mobile | 160–600 px, step 10 | 320 px | |
| **Content** | Heading | Headline (wrap words in `[ ]` to highlight); tag h1–h4 | Text | — |
| Subheading | Secondary line; tag h2/h3/h4/p | Rich text | — | |
| Text | Body paragraph | Rich text | — | |
| Primary / Secondary button | Label, link, size (2xs–2xl), style (Primary / Secondary / Text link), open in new tab | — | — | |
| Typography | Per-element font size & margin for desktop and mobile, plus light/dark colors | — | — | |
| **Media** | Media type | Image or video background | Image / Video | Image |
| Desktop / Mobile image | Background images (when type = Image) | Image | — | |
| Desktop / Mobile video | Background videos (when type = Video) | Video | — | |
| Enable autoplay | Autoplay the video | On / Off | On | |
| Enable overlay | Darkening overlay over the media | On / Off | On | |
| Overlay color / opacity | Overlay tint and strength (when overlay on) | Color / 0–100 % | `#000000` / 30 % | |
| **Background & alignment** | Background color | Tile background (light / dark mode) | Color | — |
| Content alignment | Horizontal alignment of the content | Left / Center / Right | Center | |
| Vertical alignment | Vertical alignment of the content | Top / Middle / Bottom | Middle |
Tip
Full-width promo tiles read best. Because the tile snaps to a row boundary when columns change, choosing Full width (or a span that matches your column count) keeps the grid tidy across the layout switcher's options.
Part 2 — Collections list page
Edit via the Collections list template. It shows all your collections as cards. (Section name: "Main Collection List".)
Layout settings
| Setting | What it does | Options / Range | Default |
|---|---|---|---|
| **Enable custom page width** | Constrain the page to a maximum width | On / Off | Off |
| **Custom page width** | Maximum width (when enabled) | 1400–2000 px, step 10 | 1600 px |
| **Show collection per page** | Collections shown per page | 6–26 | 12 |
Desktop layout
| Setting | What it does | Options / Range | Default |
|---|---|---|---|
| **Collection per row** | Collections per row on desktop | 2 / 3 / 4 | 3 |
| **Padding top / bottom** | Section padding | 0–180 px, step 2 | 60 px / 60 px |
| **Row gap / Column gap** | Spacing between cards | 5–25 px | 24 px / 24 px |
Mobile layout
| Setting | What it does | Options / Range | Default |
|---|---|---|---|
| **Collection per row** | Collections per row on mobile | 1 / 2 | 2 |
| **Padding top / bottom** | Section padding | 0–140 px, step 2 | 40 px / 40 px |
| **Row gap / Column gap** | Spacing between cards | 5–25 px | 10 px / 10 px |
Image loading settings
| Setting | What it does | Options | Default |
|---|---|---|---|
| **Loading** | How card images load | Lazy / Eager | Lazy |
| **Fetch priority** | Browser fetch priority | Auto / High / Low | Auto |
Animation
| Setting | What it does | Default |
|---|---|---|
| **Enable scroll animation** | Animate cards as they scroll into view | On |
Background settings
| Setting | What it does | Options | Default |
|---|---|---|---|
| **Background type** | Section background | None / Color / Media | None |
| **Background color (light/dark mode)** | Background color (when type = Color) | Color | — |
| **Use gradient** | Use a gradient background (when type = Color) | On / Off | Off |
| **Gradient color (light/dark)** | Gradient colors (when gradient on) | Color | — |
Media settings (when Background type = Media)
| Setting | What it does | Options | Default |
|---|---|---|---|
| **Media type** | Image or video background | Image / Video | Image |
| **Desktop Image / Mobile Image** | Background images | Image | — |
| **Video** | Background video | Video | — |
| **Image behavior** | Motion effect for image backgrounds | None / Ambient movement / Parallax / Zoom in / Zoom out / Fade | None |
| **Enable overlay** | Add a color overlay over the media | On / Off | Off |
| **Overlay color** | Overlay color (when overlay on) | Color | — |
| **Overlay type** | Solid or gradient overlay | Solid / Gradient | Solid |
| **Overlay gradient direction** | Direction (when gradient overlay) | Up / Down | Up |
| **Overlay opacity** | Overlay strength | 0–100 % | 40 % |
Part 3 — Global settings that affect collections
These live in Theme settings and apply everywhere products, pagination, and filters appear.
Pagination
Theme settings → Pagination. Controls the look of page navigation (the collection section's Loading type controls the behavior).
| Setting | What it does | Options | Default |
|---|---|---|---|
| **Pagination mode** | Default mode (overridden per section by *Loading type*) | Pagination / Load more | Pagination |
| **Pagination style** | Visual style of page numbers | Circle / Underline / Square / Pill / Minimal | Circle |
| **Visible page numbers** | How many page numbers to show | 3 pages / 4 pages | 4 pages |
| **Show arrows** | Show previous/next arrows | On / Off | On |
| **Show first/last** | Show first/last page links | On / Off | On |
| **Alignment** | Pagination alignment | Left / Center / Right | Center |
| **Button label** | Custom label (e.g. for load-more) | Text | — |
| **Light/Dark mode colors** | Background, Active background, Text, Active text colors | Color | — |
Note
The section-level Loading type (in the Collection section) is the authoritative control — it offers four behaviors (page refresh / AJAX / load more / infinite scroll) and overrides the global Pagination mode for that section.
Filter & sort design
Theme settings → Filter & sort. Global styling for all filter UI.
General
| Setting | Options | Default |
|---|---|---|
| **Dropdown border radius** | None / Rounded / Medium / Large / Extra large | Large |
| **Item border radius** | None / Small / Rounded / Medium | Rounded |
| **Pill border radius** | Rounded / Medium / Large / Full rounded | Full rounded |
| **Dropdown shadow** | None / Small / Medium / Large / Extra large | Large |
Light mode / Dark mode colors — Heading label, Secondary text, Hint count, Dropdown background, Dropdown border, Divider, Item hover background, Item active background, Item hover text, Item active text, Active pill background, Active pill hover background. (Each mode ships with sensible defaults.)
Product card (global styling)
Theme settings → Product card. Controls how every product card looks across the store (collections, search, featured products). Highlights:
Layout
| Setting | Options | Default |
|---|---|---|
| **Card style** | Vertical / Horizontal / Overlay | Vertical |
| **Card border radius** | 0–40 px | 0 px |
| **Enable border** | On / Off | Off |
| **Enable background** | On / Off | Off |
| **Padding scale** | Compact / Regular / Spacious | Regular |
| **Sold out treatment** | None / Grayscale / Dim | None |
| **Show "from" price** | On / Off | Off |
Note
Card shadow is not a product-card setting — it's controlled globally under Theme settings → Border radius & shadows (Shadow intensity, 0–10, default 5).
Additional options appear depending on the chosen Card style and Media mode: Horizontal layout (image position, image ratio), Overlay (opacity, blur, gradient tint, hover effect), Vertical (creative shape, cut angle), and Slideshow controls (slider pagination/arrows) plus media corner radius.
Media
| Setting | Options | Default |
|---|---|---|
| **Media mode** | Single image / Hover / Slideshow | Hover |
| **Media height** | Square (1:1) / Portrait (4:5) / Tall (2:3) / Landscape (16:9) / Fixed height / Natural | Portrait (4:5) |
| **Image fit** | Cover / Contain | Cover |
| **Image hover effect** | None / Zoom / Fade second | Fade second |
| **Enable variant image** | Show variant-specific images on hover | On |
Add button
| Setting | Options | Default |
|---|---|---|
| **Button position** | Inside content / Inside media | Inside content |
| **Inside media style** | Icon only / Text button | Icon only |
| (plus mobile equivalents) |
Alignment, Light mode, Dark mode — content alignment (Start/Center/End) and full light/dark color sets (background, text, icons, border, price, sale price) with sensible defaults.
The card-style settings interact with the per-card content blocks in Part 1: the global group sets the frame and media; the blocks set the content and typography.
How-to guides
Set up product filters
- In Shopify admin, go to Settings → Search & Discovery → Filters and add filters (price, color, size, availability, etc.).
- In the theme editor, open the Collection section → turn on Enable filtering and choose a Desktop filter placement and Mobile filter style. Save.
Add a title or banner above the product grid
- On the Collection pages template, click Add section above the Collection section.
- Add an image banner, rich text, or heading section and set its content. Save.
(The grid alone does not show a collection title — see the note at the top.)
Switch to a "Load more" button or infinite scroll
- Open the Collection section → set Loading type to Load more button or Infinite scroll. Save.
Change how many products show per row
- Open the Collection section → set Columns on desktop, Columns on tablet, and Columns (mobile). Save.
- Optionally keep Enable layout switcher on so shoppers can adjust it themselves.
Customize what appears on each product card
- Open the Collection section and expand the product card blocks.
- Add/remove blocks (Vendor, Title, Price, Rating, etc.) and drag to reorder.
- Adjust typography per block; set the overall card frame in Theme settings → Product card. Save.
Add a promotional tile inside the grid
- Open the Collection section → Add block → Promo tile.
- Set Desktop position and Mobile position (the tile appears after that product number) and choose a Width (e.g. Full width) for each breakpoint.
- Add media (image or video), heading/text, and up to two buttons; set alignment and colors. Save.
- Need more than one? Add additional Promo tile blocks — there's no limit — and give each its own position.
Best practices
- Add a banner section for branding and SEO context, since the grid has no built-in header.
- Keep cards clean. Title + Price (plus swatches and a rating) is usually enough; avoid enabling every block.
- Choose the right loading type. Pagination (AJAX) or Load more feel smooth without overwhelming; Infinite scroll suits discovery-led stores.
- Match desktop and mobile columns to your imagery. 3–4 desktop columns and 2 mobile columns work for most catalogs; use fewer for large, detailed images.
- Style filters once. Because filter/sort styling is shared with search, set it globally under Theme settings → Filter & sort and verify both pages.
- Use full-width promo tiles. When weaving a Promo tile into the grid, prefer Full width (or a span matching your column count) so it stays tidy as shoppers change columns with the layout switcher.
FAQ
Why isn't my collection's title or description showing? The grid doesn't render them automatically (they're only structured data). Add a banner/heading section above the grid.
Where do I create filters? In Shopify admin under Settings → Search & Discovery → Filters. The theme controls only placement and styling.
What's the difference between *Loading type* and *Pagination mode*? Loading type (per section) controls behavior and has four options; Pagination mode (global) is the fallback and has fewer. The section setting wins.
How do I change the product card image shape? In Theme settings → Product card → Media → Media height (e.g. Square, Portrait, Landscape).
Can the same settings affect the search page? Yes — filter/sort styling and product-card styling are shared between collections and search.
Can I put a banner or promo inside the product grid? Yes — add a Promo tile block to the Collection section. It's inserted after a product number you choose (independent desktop and mobile positions and widths), and you can add multiple tiles.
Troubleshooting
Filters aren't appearing. Confirm Enable filtering is on in the Collection section and that filters exist in Settings → Search & Discovery.
The grid shows the wrong number of columns. Check Columns on desktop/tablet/mobile in the Collection section. If shoppers can change it, the layout switcher may have been used — that's per-visitor and doesn't change your defaults.
Pagination style changes aren't visible. Pagination style is global (Theme settings → Pagination); pagination behavior is the section's Loading type. Adjust the right one.
Product cards look inconsistent across pages. Card framing/media/colors come from the global Product card settings; per-card content/typography comes from the Collection section blocks. Align both.
Collection card backgrounds/overlays aren't applying on the Collections list page. Confirm Background type is set to Color or Media, and (for media) that an image/video is uploaded and Enable overlay is configured as intended.