Collection pages
A collection page lists the products in one collection, such as a pantry staples or a holiday gift collection. In Heirloom, every collection page is built from the Collection section, which holds the collection’s title, filters, sort options and product grid. You can choose a different collection template for each collection.
Edit the collection page
Steps:
- From your Shopify admin, go to Online Store > Themes.
- Find Heirloom, and then click Edit theme.
- From the page selector at the top of the theme editor, select Collections, and then select the template that you want to edit.
- In the sidebar, click Collection, or one of the blocks inside it.
- Change the settings that you want.
- Click Save.
Collection section
The Collection section always shows these blocks, in this order: Collection header, Filters, Toolbar and Collection grid. You can’t remove them, but you can hide each one or turn off its parts. Blocks that you add go between the collection header and the products.
You can add these blocks to the collection section:
- Theme blocks, such as Heading, Text, Button and Image
- App blocks from apps you install
From 990 pixels wide, Filter layout decides where the filters sit:
- Sidebar puts the filters in a column beside the products.
- Horizontal bar puts the filters in a row above the products.
- Drawer keeps the products full width, with a Filters button that opens the filters in a panel.
- Automatic puts one or two filters in a bar above the products, and three or more in a sidebar. With a short list of filters, no long empty column sits beside the products.
On smaller screens, the products fill one column and the filters always open in a drawer. Learn more about filters and sorting.
Settings
- Filter layout: Where the filters sit from 990 pixels wide. Automatic is a bar for two filters or fewer and a sidebar for more. Phones use a drawer.
- Description layout: Where the collection description shows. First paragraph on top shows the first paragraph above the products and the rest below them, so customers reach the products sooner. All above products shows the whole description above the products.
Section style
- Color scheme: The colors of the collection page.
- Vertical padding: The space above and below the section.
Collection header
The collection header shows the collection title, its image, its description and links to its subcollections, and breadcrumbs when you turn them on. The collection title is the page’s main heading.
- Show breadcrumbs: Shows the trail "Home / collection title" above the title. It starts off, because on a collection page the trail only repeats the title under it.
- Show collection image: Shows the image that you added to the collection in your Shopify admin.
- Image position: Above title shows the image as a wide banner. Beside title puts it next to the title and description from 750 pixels wide. On a phone it sits under them as a short strip, twice as wide as it is tall, so the first products stay in view.
- Image fit: Crop to fit fills a wide band above the title, or a 4:3 frame beside it (a 2:1 strip on a phone), and crops what doesn't fit. Adapt to image keeps the image's own shape, up to its own width, so nothing is cut off. Use it for images that have text or a logo in them. Only a banner-shaped image, at least twice as wide as it is tall, stays above the title. Any other image sits beside the title.
- Show description: Shows the collection description. Turn this off to hide the description in both places when Description layout is First paragraph on top.
- Show subcollections: Shows a row of links to related collections, such as the vinegars and oils inside a pantry collection.
- Subcollections: Blank uses the menu with the same handle as the collection.
To link to subcollections, select them in Subcollections. If you leave it blank, Heirloom uses the menu that has the same handle as the collection. For example, a collection with the handle pantry shows the links from a menu with the handle pantry. You can also connect Subcollections to a collection metafield that holds a list of collections, so that each collection shows its own links.
Toolbar
The toolbar sits above the products. It shows the product count, the Sort by menu, a grid density switcher of two small icons, for three or four products in each row, and a label for each filter that a customer applied. Customers can click a label to remove that filter, or click Clear all to remove every filter and keep the sort order.
- Show sort by: Shows the Sort by menu. The sort options come from Shopify.
- Show product count: Shows how many products the collection or search has. Above 25,000 products, the count reads "25,000+ products".
- Show grid density switcher: Shows two small icons that let customers switch the grid between three and four columns on large screens. It needs JavaScript and doesn't show on phones. The chosen icon is underlined. If a customer has accepted preference cookies, their choice is remembered on their next visit.
- Applied filter labels: How each applied filter reads above the products. Value shows only the value, such as "750 ml". Filter and value adds the filter name, such as "Size: 750 ml".
Mobile
- Stick to top on mobile: Below 990 pixels wide, keeps the Filters and Sort by buttons under the header while customers scroll.
- Show quick filters: Shows your first five filter groups as buttons above the products on phones. Heirloom's own collection and search templates turn it off, so a phone shows one row with Filters and Sort by.
On phones, Filters and Sort by share one row. When the bar is narrow, the product count steps aside, and screen readers still hear it. Toolbar buttons, pills and chips follow Corner style.
Collection grid
The collection grid shows the products, a page at a time, and the links to more pages.
- Columns on desktop: How many products show in each row on large screens. Beside a filter sidebar on a smaller desktop screen, the grid shows three.
- Columns on mobile: How many products show in each row on phones.
- Products per page: How many products load on each page. A page with grid promo tiles on it counts each tile as the products it covers, so the first page ends on a full row: 36 per page with one tile shows 35 products and the tile.
- Pagination: Page numbers shows links to each page. Load more button adds the next page of products under the current ones, with a line such as "Showing 24 of 120".
Empty collection
- Empty collection message: Shown when a collection has no products; blank uses the standard message.
- Button label: Leave blank to use "Continue shopping".
- Button link: Leave empty to link to all products.
When a collection has no products, the grid shows a short message and a Continue shopping button, centered. Under Empty collection in the grid’s settings, you can change the message, the button label and where the button goes. A blank one uses the standard wording and your all products page. When a customer’s filters match no products, the grid shows Clear all instead.
Add a promo tile to the grid
A grid promo is a tile that sits among the products, such as a photo of a recipe made with the collection’s products, or a note about a seasonal offer.
Steps:
- In the theme editor, open the collection template that you want to change.
- In the sidebar, under Collection grid, click Add block, and then select Grid promo.
- Add an image, a heading, text and a link.
- In Position, enter the product slot where the tile should appear.
- Click Save.
- Image: The tile's background photo. With an image, the text sits over a dark shade so it stays readable. Without one, the tile is a plain panel.
- Heading: The tile's heading.
- Text: A short line under the heading.
- Button label: The text of the tile's button.
- Link: Where the tile links to.
Layout
- Position: Counts product slots from the start of the grid.
- Size: Standard takes one product slot. Wide spans two columns, Tall spans two rows, and Large spans both.
Collection templates
Heirloom includes four collection templates. Each one starts with a different layout that you can change in the theme editor.
| Template | What it shows |
|---|---|
| Default collection | Filters in a sidebar and four products in each row, followed by a Recently viewed section. Each theme style starts this template with its own filter layout and number of columns. |
| compact | Filters in a drawer, no collection image, four products in each row and a Load more button. Nothing below the products. |
| editorial | Filters in a drawer, the image beside the title, the whole description above the products, and three products in each row (two on phones), 12 to a page. Media with text and Featured blog sections follow. |
| promo | A slim Promo banner above the products, a grid promo tile among them, and a Promo tiles section below. Use it for a sale or a seasonal edit. |
Assign a template to a collection
Steps:
- From your Shopify admin, go to Products > Collections.
- Click the collection that you want to change.
- In the Theme template section, select a template, such as editorial.
- Click Save.
To create your own template, open a collection template in the theme editor, and then use Create template from the page selector. Learn more about templates.
Collections list page
The collections list page shows a grid of all your collections. It uses the Collections grid section, on the Collections list template. Each card shows the collection’s image, or the image of its first product if the collection has none.
You can add these blocks above the grid:
- Theme blocks, such as Heading, Text, Button and Image
- App blocks from apps you install
- Heading: The page's main heading. Leave it blank to use "Collections" in the customer's language.
Layout
- Columns on desktop: How many collections show in each row on large screens. Narrower screens show one or two.
- Collections per page: How many collections load on each page. More collections show on further pages.
- Image shape: The shape of each collection image. Images are cropped to fit.
- Show product count: Shows how many products are in each collection.
- Show excerpt: Shows the start of each collection's description.
Section style
- Color scheme: The colors of the section.
- Vertical padding: The space above and below the section.
Product grids in other sections
The Featured collection, Related products and Recently viewed sections show their products in a grid or a carousel. You set this on the section itself, under Layout:
- Layout shows the products in rows (Grid), or in one row that customers swipe or drag with a mouse (Carousel).
- Products to show sets the most products that show, from 2 to 12. Related products and Recently viewed show up to 10.
- Columns on desktop and Columns on mobile set how many products show in each row.
- Show arrows adds previous and next buttons to a carousel, when there are more products than fit.
Under Product cards, Image shape and Quick add change the cards in that section only, instead of following Theme settings > Product cards. Learn more about product sections.
The Product grid block under the section has some of the same settings. Each one shows only while it differs from its default, and while it shows, it can take the place of the section’s own setting:
- Layout: Shows while it's set to Carousel. Set it to Grid to use the section's Layout.
- Products to show: Shows while it's set to anything other than 4. Set it to 4 to use the section's Products to show.
- Columns on desktop (this shelf): Shows while it's set to 2 or 3, and replaces the section's Columns on desktop while that is at 4. Set it to 4 to use the section's Columns on desktop.
- Columns on mobile: Shows while it's set to 1. Set it to 2 to use the section's Columns on mobile.
- Show arrows: Shows while it's off. Turn it on to use the section's Show arrows.
Related
- Learn more about filters and sorting.
- Learn more about image sizes.
- Learn more about collection sections.
- Learn more about collections in Shopify’s Help Center.