Product pages
Every product page in your online store uses a product template. The main part of each template is the Product section: the product’s media on one side, and its details and purchase form on the other.
Edit your product pages
Steps:
- From your Shopify admin, go to Online Store > Themes.
- Find Heirloom, and then click Edit theme.
- At the top of the theme editor, open the page selector, and then select Products > Default product.
- In the sidebar, click the Product section or one of its blocks, and then change its settings.
- Click Save.
Changes to a template apply to every product that uses it. To give some products a different layout, assign them another template. Learn more in Product templates.
The product section
The product section has two columns:
- Product media shows the product’s images, videos and 3D models. It always comes first in the section. You can hide it, but you can’t remove it or move it.
- The details column holds every other block, in the order you choose. It takes product information blocks, such as Product title, Price and Description, theme blocks such as Text and Collapsible row, and app blocks.
You can add these blocks to the product section:
- Theme blocks, such as Heading, Text, Button and Image
- App blocks from apps you install
- Product options
- Purchase form
On large screens the two columns sit side by side. On smaller screens they stack, with the media on top.
A section can have one Product options block and one Purchase form block. If you add a second copy, then it’s hidden on your online store, and the theme editor shows a note on it.
Settings
Layout
- Image position: Which side of the page the media is on, on large screens. On smaller screens, the media is always above the details.
- Image width: How wide the media column is next to the details. Small makes the media narrower than the details, Medium makes it a little wider, and Large gives it most of the width.
- Sticky product details on large screens: Keeps the buy box visible while customers scroll the product gallery on large screens.
- Show breadcrumbs: Shows the trail of links above the product, such as Home / Coffee / Morning Filter Coffee. It needs Show breadcrumbs on in Theme settings > Store features too. Turn it off here to hide the trail on this template only.
Subscriptions
- Preselect: For products that you sell by subscription, which purchase option is selected when the page opens. Products that are sold only by subscription always open on a subscription. Learn more about subscriptions.
Section style
- Color scheme: The colors of the section.
- Vertical padding: The space above and below the section.
Learn more about product information blocks.
The first line of the details column starts at the top of the image, so the brand or the title lines up with the picture. Options, product details, purchase options, the quantity and the gift message share one label style.
Product media
The Product media block shows the media that you add to the product in your Shopify admin. When a customer chooses a variant, the gallery moves to that variant’s image, so assign an image to each variant that has one. Learn more about adding images to variants in Shopify’s Help Center.
Gallery layout sets how a product with more than one item looks on large screens:
- Carousel, thumbnails beside: the main image with a column of thumbnails next to it. When there are more thumbnails than fit beside the image, the column scrolls.
- Carousel, thumbnails below: the main image with a row of thumbnails under it.
- One column: every item stacked in one column. With Sticky product details on large screens on, the details stay in view beside them as customers scroll.
- Two-column grid: the items two to a row. With an odd number of items, the first one spans the full width of the media column, so no row is left half empty.
In both carousels, customers swipe the main image or click a thumbnail to see the next item. When a customer chooses a variant, the carousels move to its image, and One column and Two-column grid move its image to the top.
On phones, every layout is a carousel that customers swipe. The two thumbnail layouts show the row of thumbnails under the image. One column and Two-column grid show the edge of the next item instead.
With Zoom images on click on, customers click an image to open it larger, fitted to their screen. When the photo is larger still, clicking it again shows more detail, and customers can drag or scroll to look around it. They can use the arrow keys to move between images, and press Escape or click outside the image to close it.
Videos play one at a time: moving to another item pauses the video. A 3D model shows an Open 3D model button, and on devices that support augmented reality, a View in your space button.
Settings
- Image shape: The shape of the media frames. Original keeps the shape of your images: the gallery takes the shape of the first item, and stacked items each keep their own shape, between tall (2:3) and wide (16:9). An image smaller than its frame shows at its own size instead of being stretched. The other options give every item the same shape.
- Gallery layout: How the gallery looks on large screens, for products with more than one image, video or 3D model. Phones always show a carousel.
- Show thumbnails: Shows only when it's off, which a store could set before Gallery layout existed. While it's off, the two carousel layouts show every item in one column instead. Two-column grid isn't affected. Turn it on to use Gallery layout.
- Zoom images on click: Opens the clicked gallery image larger. Videos and 3D models are unchanged.
Product options
The Product options block shows a picker for each of the product’s options, such as size or flavor, as buttons, swatches or dropdown menus. It shows only for products that have more than one variant. By default, Option style is Buttons, dropdown for long lists, so an option with many values, such as twelve flavors, shows as a dropdown. Learn more in Variants and swatches.
Purchase form
The Purchase form block holds the add to cart button and everything that goes with it. From top to bottom, it shows:
- the gift card recipient form, on gift card products
- the purchase options, for products that you sell by subscription or pre-order
- the quantity selector
- the add to cart button
- the accelerated checkout buttons, such as Shop Pay. On gift card products with the recipient form on, these buttons are hidden.
The button reads Add to cart, or Sold out when the selected variant is sold out. To use your own words, such as “Add to basket”, fill in Add to cart label and Sold out label. The sticky bar uses the same labels. When a customer chooses a combination of options that doesn’t exist, the button reads Unavailable. Both buy buttons are 40 pixels tall with a mouse and 44 pixels on touch screens, and the quantity box matches them.
Buy it now button style
Under Add to cart, the accelerated checkout button, such as Buy it now, can look like a lighter outline button or like Add to cart. Buy it now button style sets which. It starts on Secondary, the outline button, so the page has one filled button. A purchase form saved with Primary, like Add to cart keeps it after an update. Shop Pay and other wallet buttons keep their brand colors either way.
Settings
Buttons
- Add to cart label: The add to cart button's label, on the page and in the sticky bar. Leave it blank to show "Add to cart" in the customer's language.
- Sold out label: The button's label when the selected variant is sold out. It also marks sold out variants in the variant list that shows when JavaScript is off. Leave it blank to show "Sold out" in the customer's language.
- Show sticky add to cart bar: When the add to cart button scrolls out of view, a bar at the bottom of the screen shows the product title, the price, the quantity when it's more than one, and an add to cart button.
Checkout
- Show accelerated checkout buttons: Shop Pay and other accelerated buttons. Brand colors cannot be changed.
- Buy it now button style: Secondary shows the Buy it now button as an outline button under Add to cart. Primary, like Add to cart shows two filled buttons. It shows when Show accelerated checkout buttons is on.
- Pre-order button label: The add to cart button's label while a pre-order or try before you buy option is selected. Leave it blank to use the purchase option's name. This setting shows only when Show accelerated checkout buttons is off, because those buttons name the purchase option themselves. Learn more about pre-orders.
Gift cards
- Show gift card recipient form: Lets buyers send a gift card by email with a message and date. Hides accelerated checkout on gift cards.
Learn more about the gift card recipient form in Gifts and gift cards.
Quantity
The Quantity block sits inside the purchase form. It shows a quantity field with minus and plus buttons. If you sell to B2B customers with quantity rules, then the field follows each variant’s minimum, maximum and increment. The rules show under the field, along with how many of the variant are already in the cart. Learn more about quantity rules in Shopify’s Help Center.
When you track a variant’s inventory and don’t continue selling when it’s out of stock, customers can’t choose more than you have.
Settings
- Show quantity selector: Shows the quantity field. When it's off, customers buy the minimum quantity, which is 1 unless a quantity rule sets more. Quantity rules still show.
Product templates
Heirloom includes these product templates. They all use the product section, with different blocks and sections around it.
| Template | What it’s for |
|---|---|
| Default product | Every product that you don’t assign another template to. It shows the full set of details: vendor, title, rating, price, stock, dietary preferences, options, the purchase form, pickup, complementary products, the description, provenance, allergens, storage, rows for ingredients, nutrition, shipping and returns, disclosures and share links. The description sits above the complementary products. Three common questions, about delivery, order confirmation and payment, are expandable rows after the policy rows. They’re hidden until you show them in the theme editor. Under the product section are app blocks, related products in four columns and recently viewed products. |
| gift | Products that you sell as gifts, such as hampers and gift sets. It adds a Highlights block, a Gift message block above the purchase form, and complementary products titled “Add to the gift”. Under the product section are a Media with text section about gift wrapping and a Featured collection section that shows four products from your All collection. |
| simple | Products that need only the essentials: vendor, title, price, stock, options, the purchase form, pickup, the description and disclosures, then related products. |
| bulk-order | Products that business customers order in several variants at once. It shows the vendor, title, price and description, and then a Quick order list with a row and a quantity field for every variant. Learn more in Wholesale and B2B. |
| tasting | Products with tasting notes, such as coffee, tea, cheese or olive oil. It adds flavor values, a Tasting notes block with rows for Nose, Palate and Finish, and the Pairings and Recipe sections. |
| Seller product | 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 shows the core product details without pickup availability or complementary products. It’s available to some stores only. |
Learn more about the gift template in Gifts and gift cards, and about tasting notes in Food and drink details.
Assign a template to a product
Steps:
- From your Shopify admin, go to Products.
- Click the product that you want to change.
- In the Theme template section, select a template from the drop-down menu.
- Click Save.
To change the template of many products at once, use the bulk editor. Learn more about applying templates in Shopify’s Help Center.
Related
- Learn more about product information blocks.
- Learn more about variants and swatches.
- Learn more about image sizes.
- Learn more about templates in Heirloom.
- Learn more about product media types in Shopify’s Help Center.