HeirloomHelp CenterContact support

Cart

The cart shows what a customer is about to buy, with the subtotal and the way to checkout. Heirloom has a cart drawer, which slides in over the page when a customer adds a product, and a full cart page. Both show each item the same way.

Choose the cart type

Cart type in Theme settings > Cart decides what happens when a customer adds a product or clicks the cart icon.

  • Drawer opens the cart in a panel over the current page, so customers can keep shopping. This is the default.
  • Page takes customers to the cart page.

The cart page is always available at /cart, whichever type you choose. Learn more about cart settings.

What the cart shows

Each item in the cart shows:

  • the product image, title and options, such as size or roast
  • the vendor, when Show vendor on line items is on in Theme settings > Cart (it’s off by default)
  • the price, the price of each item when there’s more than one, the unit price when the product has one, and any discounts on the item
  • the purchase option, such as a subscription, which customers can change in the cart
  • any custom details that the customer entered on the product page, such as a gift message
  • a quantity field, and a Remove link
  • any quantity rules for the item, such as a minimum of six
  • the products inside a bundle, and add-ons listed under the item that they were added with
  • any product disclosures that you set to show in the cart

Under the items, the cart shows any blocks that you add, the order note, discounts on the whole order, the subtotal and a line about taxes. Then come the Checkout button and the accelerated checkout buttons.

When a customer has store credit, the cart shows their balance. When your store offers Shop Pay Installments, the installments message shows under the subtotal.

Cart page

Steps:

  1. From your Shopify admin, go to Online Store > Themes.
  2. Find Heirloom, and then click Edit theme.
  3. From the page selector at the top of the theme editor, select Cart.
  4. In the sidebar, click Cart.
  5. Change the settings that you want.
  6. Click Save.

The Cart section always shows the Cart items and Cart totals blocks. On large screens the totals sit beside the items, and on smaller screens they move below them. Blocks that you add to the section show under the cart.

You can add these blocks to the cart section:

  • Theme blocks, such as Heading, Text, Button and Image
  • App blocks from apps you install

Section style

  • Color scheme: The colors of the cart page.
  • Vertical padding: The space above and below the section. Options: None, Small, Medium, Large. Default: Medium.
  • Heading: The page title. Leave it blank to show Cart in each customer's language.
  • Summary style: Plain puts the subtotal and Checkout on the page beside the items. Panel puts them in a soft box with a thin border. Options: Plain, Panel. Default: Plain.

Empty cart

  • Message: The message for an empty cart. Leave it blank to show Nothing in your cart yet. in each customer's language.
  • Button label: The button under the empty cart message. Leave it blank to show Continue shopping.
  • Button link: Where the empty cart button goes. Leave it blank to link to all products.

Product suggestions

  • Show suggestions: Shows You might also like under the cart items, and under the empty cart message. It is on by default. On by default.
  • Heading: The heading over the suggestions. Leave it blank to show You might also like in each customer's language.
  • Source: Where the suggestions come from. Learn more in You might also like. Options: Related products, Complementary products, Collection only. Default: Related products.
  • Collection: The collection to suggest products from when the cart is empty, when Shopify has no recommendation to make, or when Source is Collection only. Leave it blank to suggest from all products.
  • Products to show: How many products to suggest, from 1 to 8. The cart page shows 4 by default. From 1 to 8, default 4.
  • Layout: Product cards shows the same cards as your collection pages, with the quick add button from Theme settings > Product cards. Compact list shows the small rows from the cart drawer, side by side. Options: Product cards, Compact list. Default: Product cards.
  • Add button: With Compact list, how customers add a suggestion. Learn more in You might also like. Options: Text link, Outline, None. Default: Text link.

When the cart is empty, the page shows a short message and a button to keep shopping. You can change both in the settings above.

Cart drawer

The Cart drawer section is part of the header, so you edit it once for every page. It shows only when Cart type is Drawer.

Steps:

  1. In the theme editor, in the Header area of the sidebar, click Cart drawer. The drawer opens in the preview.
  2. Change the settings, or add blocks.
  3. Click Save.

You can add these blocks under the items in the drawer:

  • Custom Liquid
  • App blocks from apps you install
  • Color scheme: The colors of the drawer panel. The page behind it keeps its own colors.
  • Heading: The drawer title, shown before the number of items. Leave it blank to show Cart in each customer's language.

Empty cart

  • Message: The message for an empty cart. Leave it blank to show Nothing in your cart yet. in each customer's language.
  • Button label: The button under the empty cart message. Leave it blank to show Continue shopping.
  • Button link: Where the empty cart button goes. Leave it blank and the button closes the drawer, so customers stay on the page they were on.

Product suggestions

  • Show suggestions: Shows You might also like under the items in the drawer, and under the empty cart message. It is on by default. On by default.
  • Heading: The heading over the suggestions. Leave it blank to show You might also like in each customer's language.
  • Source: Where the suggestions come from. Learn more in You might also like. Options: Related products, Complementary products, Collection only. Default: Related products.
  • Collection: The collection to suggest products from when the cart is empty, when Shopify has no recommendation to make, or when Source is Collection only. Leave it blank to suggest from all products.
  • Products to show: How many products to suggest, from 1 to 8. The drawer shows 2 by default, which fills the drawer under one item without crowding it. From 1 to 8, default 2.
  • Layout: Two across shows each product as a small card with its image on top. Compact list shows a row per product, with a small image beside the name. Carousel shows the cards in a row that customers swipe, with arrows when the cards don't all fit. Options: Two across, Compact list, Carousel. Default: Two across.
  • Add button: How customers add a suggestion. Learn more in You might also like. Options: Text link, Outline, None. Default: Text link.

The drawer has a View cart link to the cart page. In the drawer and on the cart page, the order note starts closed unless the customer already wrote one.

You might also like

Under the cart items, and under the empty cart message, Heirloom shows You might also like: a few products for the customer to add. By default the drawer shows two small cards side by side, and the cart page shows a row of product cards. You can change the heading, the number of products, the layout and the add button in the settings of each section.

Source decides where the suggestions come from:

  • Related products uses Shopify’s product recommendations for the first item in the cart. This is the default.
  • Complementary products uses the products that you pair with the first item in the Search and Discovery app. Learn more about complementary products in Shopify’s Help Center.
  • Collection only always uses the collection in Collection.

When Shopify has no recommendation to make, or the cart is empty, the suggestions come from the collection in Collection, or from all products when that’s blank. A product that’s already in the cart or sold out is never suggested.

Add button decides how customers add a suggestion in the drawer, and on the cart page with Compact list:

  • Text link shows a quiet Add link. This is the default.
  • Outline shows an outline button in your theme’s button style.
  • None shows no button. Customers click the product to open its page.

A product with one variant goes straight into the cart. A product with more than one variant, a gift card, or a product that needs a subscription or a quantity rule, shows Choose options instead, which opens the product page.

When a customer adds a suggested product, the cart shows Shopify’s message under the row if Shopify refuses the add, and the drawer reads out the new subtotal for screen readers.

Add blocks to the cart totals

The Cart totals block, on the cart page and in the drawer, takes blocks of its own. They show above the order note.

  • Free shipping progress shows how close the cart is to free shipping.
  • Text adds a short message, such as packing or delivery times.
  • Custom Liquid and app blocks add content from code or apps.

Steps:

  1. In the theme editor, click Cart totals inside the Cart section or the Cart drawer section.
  2. Click Add block, and then select a block.
  3. Click Save.

Cart totals also has settings for its own labels. The cart page and the drawer each keep their own, so you can word them differently.

  • Checkout button label: The text on the Checkout button. Leave it blank to show Checkout in each customer's language.
  • Order note label: The title of the order note. It shows when Allow order notes is on in Theme settings > Cart. Leave it blank to show Order note.
  • Link label: The text of the link under the checkout buttons. Leave it blank to show View cart in the drawer and Continue shopping on the cart page. If you set a Link and leave the label blank, both show Continue shopping.
  • Link: Where that link goes. Leave it blank to go to the cart page from the drawer, and to all products from the cart page.

Free shipping progress

The Free shipping progress block tells customers how much more they need to spend to get free shipping, with a bar that fills as they add products. When they reach the amount, it says so. The block is already in Cart totals on the cart page and in the drawer, so you only need to enter the amount.

Steps:

  1. In the theme editor, click the Theme settings icon, and then click Cart.
  2. In Free shipping threshold, enter the order total that earns free shipping, in your store currency. For example, enter 75.
  3. Click Save.

Free shipping threshold is in the Cart settings. The block uses this one amount everywhere, and so do shopping assistants if you turn on agent tools. Until you enter an amount, the block stays hidden on your online store, and the theme editor shows a reminder. It also stays hidden when the cart is empty or holds only items that don’t need shipping.

  • Progress message: Your own message while the cart is under the threshold, such as "Spend [amount] more for free delivery". Write [amount] where the money left goes. Leave it blank to show [amount] away from free shipping in each customer's language.
  • Show when the threshold is reached: Keeps the block visible after the cart reaches the threshold, with a message that shipping is free. When it's off, the block hides at that point. On by default.
  • Reached message: Your own message once the cart reaches the threshold. Leave it blank to show Your order qualifies for free shipping. in each customer's language.

Your own messages show in the language you write them in. Leave them blank if your store sells in more than one language, so each customer sees the theme’s translation.

When customers shop in another currency, Heirloom converts the threshold to their currency in the browser. If JavaScript doesn’t load, the block stays hidden for those customers rather than show the wrong amount.

Order notes

When Allow order notes is on in Theme settings > Cart, the cart shows an Order note field where customers can leave instructions, such as a gift message or a delivery note. You see the note on the order in your Shopify admin.

Quantity rules

When a product has quantity rules, such as a minimum of six or sold in cases of 12, the cart shows the rule under the item. The quantity buttons step by the rule’s increment. If a customer enters a quantity that the rule doesn’t allow, Shopify refuses the change and the cart shows its message under the item. Learn more about quantity rules for wholesale customers.

Accelerated checkout buttons

Accelerated checkout buttons, such as Shop Pay, Apple Pay and Google Pay, let customers skip parts of checkout. Which buttons show depends on the payment methods that you set up and on the customer’s device.

To show or hide them on the cart page and in the cart drawer, turn Show Shop Pay and wallets on or off in Theme settings > Cart. It’s on by default. On the product page, the Purchase form block has its own setting. Learn more about accelerated checkouts in Shopify’s Help Center.

Without JavaScript

The cart works in every browser. If JavaScript doesn’t load, the cart icon opens the cart page, customers change quantities and click Update cart, and Remove removes an item. The order note is saved when they click Update cart or Checkout. Customers can’t change an item’s purchase option in the cart without JavaScript, and the You might also like products come from the collection in Collection instead of Shopify’s recommendations.