Templates in Heirloom
Every page of your online store uses a template, and a template is a set of sections in a fixed order. Heirloom comes with a default template for each page type, plus alternate templates for common food and drink pages, such as a tasting product, a recipe post or a visit page. You can use them as they are, change them, or base new templates on them.
Heirloom’s templates
You open a template from the page selector at the top of the theme editor. Default templates are named after their page type, such as Default product. Alternate templates are listed by their own names, such as tasting.
Products
| Template | What it holds | Use it for |
|---|---|---|
| Default product | Product images, price, options and buy buttons, pickup availability, complementary products, the description, provenance and product details, and expandable rows for ingredients, nutrition, shipping and returns. Three common questions about delivery, order confirmation and payment are ready as rows but start hidden. Then related products and recently viewed products. | Most products. |
| simple | A shorter product page: price, stock, options, buy buttons, pickup availability, the description and disclosures, then related products. | Staples, refills and products that need little explanation. |
| tasting | The default product page plus a Tasting notes block, with the product images stacked beside the details and no complementary products. Then pairings, a recipe, related products and recently viewed products. Pairings and the recipe show nothing until you pick products or fill them in, or connect them to product metafields. | Coffee, tea, cheese, olive oil, chocolate and other products that you describe by taste. |
| gift | The default product page plus Ready to give highlights and a Gift message block above the buy buttons, then a media with text section about gift wrapping and a featured collection. | Gift boxes, hampers and anything customers buy for someone else. |
| bulk-order | A short product summary, then a Quick order list that shows every variant of the product as a row with its own quantity field. | Wholesale buyers and products that customers order in several variants at once. Learn more in Wholesale and B2B. |
| Seller product | The product details, purchase form, description, disclosures and share links, without pickup availability, complementary products or shipping and returns rows. Then related and recently viewed products. | Products from another store that you show through an eligible app. Shopify assigns this template to those products, and you can’t assign it yourself. It’s available to some stores only. |
Collections
| Template | What it holds | Use it for |
|---|---|---|
| Default collection | The collection header, filters, sorting and product grid, then recently viewed products. | Most collections. |
| compact | The collection with filters in a drawer, no collection image, four columns (two on phones), a Load more button, and nothing below the grid. | Large collections that customers browse quickly, such as a full pantry range. |
| editorial | The collection with its image beside the title and the description above three columns of products, then a media with text section and a featured blog. | Seasonal edits and brand stories, such as a harvest or holiday collection. |
| promo | The collection without its image, with a wide promo tile among the products, then a promo banner and two promo tiles below the grid. | Sales, limited offers and subscriptions. |
The Collections list template lists all your collections in a Collections grid, followed by a featured collection.
Pages
| Template | What it holds | Use it for |
|---|---|---|
| Default page | The page title and the content you write in your Shopify admin. | Policies, shipping information and other text pages. |
| about | Your page content, then columns, a media with text section, a gallery and a featured collection. | Your story, your makers and how you produce. |
| contact | A contact form, then one FAQ with a question about reply times and your shipping and refund policies. | Your contact page. |
| faq | Your page content, then one FAQ with common questions and your shipping, refund and subscription policies, and a contact form. | Common questions about delivery, storage and orders. |
| landing | A media banner, a promo banner with a countdown, a featured collection, a media with text section, a comparison table and an FAQ. | Campaigns, launches and pages you link to from ads. |
| lookbook | A media banner, a lookbook with product hotspots on a photo, promo tiles, a gallery and a featured collection. | Styled table settings, gift guides and seasonal shoots. |
| story | Your page content in a narrow column, then a featured collection. A media with text section and two custom sections, one with a before and after slider and one with a quote, are hidden until you add your own photos and text. | Long-form brand stories and journal-style pages. |
| subscriptions | Your page content, then a featured collection, process steps, and one FAQ with a question about changing or canceling and your subscription policy. | Explaining how your subscriptions work. Learn more in Subscriptions. |
| visit | Your page content, then a map, store hours and a media with text section. | A shop, tasting room or market stall that customers can visit. Learn more in Store hours and local pickup. |
| wholesale | A media banner, a contact form, process steps and an FAQ. | Wholesale inquiries from shops and restaurants. Learn more in Wholesale and B2B. |
| agents | An agent guide: your page content, then a summary of your store for AI shopping assistants. | The page you choose in Theme settings > Agents and MCP. Learn more in Agents and MCP. |
Blogs and blog posts
| Template | What it holds | Use it for |
|---|---|---|
| Default blog | The blog’s posts in a grid, with tag links and pagination, then a featured collection. | Every blog. |
| Default blog post | The post with its header, body and footer, then a featured collection and more posts from the blog. | News, guides and journal posts. |
| recipe | The post, then a Recipe section, the products to cook it with and more posts from the blog. The Recipe section shows nothing until you add your recipe. | Recipe posts. Learn more in Blogs and recipes. |
Other pages
| Template | What it holds |
|---|---|
| Home page | The sections of the theme style you chose. In the Heirloom style, that’s a slideshow, a scrolling marquee, a collection list, a featured collection, a media with text section, a lookbook, collection tabs, promo tiles, a featured product, pairings, a featured blog, a gallery and a newsletter signup. |
| Cart | The cart items and totals, with free shipping progress, and the You might also like row of suggested products that the cart section shows. |
| Search | Search results with filters and sorting. |
| 404 page | The page customers see when a link is broken, with a heading, a short message, a search field and a Back to home link. A featured collection below it starts hidden. |
| Password | The page customers see while your store is in private mode. |
| Gift card | The page a customer opens from their gift card email, with the balance, the code, a QR code, a print button and, when available, an Apple Wallet link. It has no sections to edit. |
Create a template
Create a template when some pages of one type need a different layout from the rest, such as a set of products that need a size guide. A new template starts as a copy of the template it’s based on.
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 a page type, such as Products.
- Click Create template.
- Enter a name for the template, and then select the template it’s based on.
- Click Create template.
- Add, remove and rearrange sections, and then click Save.
Changes to a template apply to every product, collection, page, blog or blog post that uses it.
Assign a template
You create templates in the theme editor, and you assign them in your Shopify admin. Only templates in your published theme appear in the Theme template list, so publish Heirloom, or the copy that you’re working on, before you assign its templates. Until then, a product shows the templates of your live theme, and you can’t assign a second template from the unpublished copy.
Products
Steps:
- From your Shopify admin, go to Products.
- Click the product.
- In the Theme template list, select a template.
- Click Save.
To change the template of many products or collections at once, select them in the list, click Bulk edit, and then add the Template column.
Collections
Steps:
- From your Shopify admin, go to Products > Collections.
- Click the collection.
- In the Theme template list, select a template.
- Click Save.
Pages
Steps:
- From your Shopify admin, go to Online Store > Pages.
- Click the page.
- In the Online store section, select a template from the Theme template list.
- Click Save.
Blogs
Steps:
- From your Shopify admin, go to Content > Blog posts.
- Click Manage blogs, and then click the blog.
- In the Online store section, select a template from the Theme template list.
- Click Save.
Blog posts
Steps:
- From your Shopify admin, go to Content > Blog posts.
- Click the blog post.
- In the Online store section, select a template from the Theme template list.
- Click Save.
Page section
The Page section is the main section of the default page template and of the about, faq, story, subscriptions and visit templates. It shows breadcrumbs, the page title and the content that you write in your Shopify admin, with comfortable reading text for headings, lists, tables, images and video.
You can add these blocks after the page content:
- Theme blocks, such as Heading, Text, Button and Image
- App blocks from apps you install
Settings
- Show page title: Turn off when a banner above already shows the page title.
- Heading size: The size of the page title.
- Content width: How wide the page content can get. Narrow suits long reading, and Wide gives tables and wide images more room.
- Alignment: Where the page content sits. Center places it in the middle of the page. Left lines the title and text up with the left edge of the sections below them.
Section style
- Color scheme: The colors of the page.
- Vertical padding: The space above and below the page content.
404 page
The 404 page appears when a customer follows a broken or old link. Heirloom’s 404 template comes with a heading, a short message, a search field with quick results, and a Back to home link. Everything on it is a block, so you can change the wording, add a button to your best sellers or remove what you don’t need. A Featured collection section below it starts hidden. To show products under the message, show that section and choose a collection.
You can add these blocks:
- Theme blocks, such as Heading, Text, Button and Image
- App blocks from apps you install
Settings
- Alignment: Where the heading, text, search field and button line up.
- Content width: How wide the content can get.
Section style
- Color scheme: The colors of the page.
- Vertical padding: The space above and below the content.
Password page
Customers see the password page while your store is in private mode, for example before you launch. Heirloom’s password page shows one panel with your logo or store name, a heading, a short message, an email signup and your social media links, followed by the message and password field that you set in your Shopify admin. The email signup is the page’s main button. The password button beside its field is the quieter outline button. If you remove the signup, the password button becomes the main button.
You can add these blocks to the panel, above the password field:
- Theme blocks, such as Heading, Text, Button and Image
- App blocks from apps you install
Settings
- Show logo or shop name: Shows your logo at the top of the panel, from Theme settings > Brand. Without a logo, your store name shows instead, in your heading font and sized to fit on one line.
Media
- Background image: A photo behind the whole page. It fills the screen and is cropped to fit.
- Overlay opacity: Darkens the image so light text stays readable.
Layout
- Style: How the panel sits on the page. Card puts it in a box with a border and shadow, and Plain sets it straight on the page or the photo.
Section style
- Color scheme: The colors of the page, the panel and the overlay.
- Vertical padding: The space above and below the panel.
How the password page works
- Your header and footer don’t show on the password page, so it stays focused on the panel.
- Customers who sign up with the email signup are added to your customers in your Shopify admin as subscribers to email marketing, with the tags
newsletter,prospectandpassword page, so you can email them when you open. - The password field and its message come from your private mode settings. A customer who enters the right password sees your online store.
- The page works without JavaScript, so it loads quickly on any device.
Turn private mode on or off
Steps:
- From your Shopify admin, go to Online Store > Preferences.
- In the Store access section, turn Private mode on or off.
- To change what customers see, enter a password and an optional Message to your visitors.
- Click Save.
To edit the password page, open the page selector at the top of the theme editor and select Password.
Related
- Learn more about templates in Shopify’s Help Center.
- Learn more about private mode and the password page in Shopify’s Help Center.
- Learn more about blogs and recipes.
- Learn more about adding sections and blocks.