Smart Cart: Cart Subtotal and Order Discount Summary

Use this article to change the wording of the subtotal line in your Smart Cart and to show shoppers a breakdown of the order discounts they have earned. The settings live in your Rebuy admin under Cart & Merchandising, then Smart Cart, your cart, then Cart Subtotal in the editor sidebar.

Cart Subtotal is the component that renders the subtotal row in your Smart Cart. It ships in the Footer anchor, directly above the checkout buttons. It is in every Smart Cart and cannot be added, removed, or hidden, so its row in the editor sidebar has no visibility toggle and no delete control.

You can still move it. Drag the Cart Subtotal row in the editor sidebar into whichever anchor you want it in, the same way you move any other component. The one place it cannot go is the Fixed Top Bar, which holds the cart title, Cart Share, and Login Button and does not accept a dropped component of any type.

The Order Discount Summary described in this article depends on your Discount/Gift Card Code Input component as well as on this one. If you do not have that component in your cart, see Smart Cart: Discount Codes and Storefront API Integration first.

The Order Discount Summary described in this article depends on your Discount/Gift Card Code Input component as well as on this one. If you do not have that component in your cart, see Smart Cart: Discount Codes and Storefront API Integration first.

The Cart Subtotal component has its own settings screen inside the Cart Editor.

The component opens with a Subtotal Label Options section. A Discount Summary section appears beneath it once your store meets the conditions described later in this article, and an Advanced card sits at the bottom.

The subtotal label is the text beside the subtotal amount, and the Smart Cart uses a different one depending on how many items are in the cart. Each field is in the Subtotal Label Options section and each accepts HTML.

Each field accepts the {{item_count}} placeholder, which the cart replaces with the number of items currently in the cart. Use it once per field. The cart replaces the first {{item_count}} in a label and leaves any later copy alone, so a second copy is shown to shoppers as raw text.

For example, changing Subtotal Label (plural) to Your {{item_count}} items shows a shopper with three products in the cart Your 3 items.

The count comes from the line items the cart is displaying. An item hidden with the smart-cart-hidden product tag is left out of it, and when Nested Cart Items is on, items grouped underneath a parent line are left out of it too.

Order Discount Summary adds an expandable breakdown of the order-level discounts applied to the cart underneath the subtotal row. It is in the Discount Summary section of the Cart Subtotal component, and that section appears only once your store has a Storefront API access token and your cart has a Discount/Gift Card Code Input component.

With the summary on, the subtotal row is followed by a line telling shoppers how many order discounts are applied, with a chevron they can click to expand it. Expanding it lists each discount by name with the amount it took off. The breakdown starts collapsed when the page loads and stays as the shopper left it until they load another page.

Whether or not the Order Discount Summary is on, the subtotal amount changes as soon as a discount applies. It shows the discounted total with the pre-discount total struck through beside it, so shoppers see what the discount saved them without expanding anything.

The Order Discount Summary depends on Shopify's Storefront API, so the toggle is hidden or disabled until your setup supports it. Each of the following has to be true.

Once all of those hold, turn Order Discount Summary on and click Save.

Even with the toggle on, the summary appears on your storefront only when there is something for it to list. A cart with no order-level discount and no gift card applied shows the plain subtotal row instead.

The Order Discount Summary lists discounts that apply to the order as a whole, and it does so through Shopify's Storefront API, which is why it needs Use Storefront API turned on for your Discount/Gift Card Code Input component. Rebuy builds the summary from the cart's order-level discount applications and from any gift card the shopper has applied, so each of those gets its own row with the amount it took off. A discount row shows the discount's name in capitals, and a gift card row reads GIFT CARD followed by the card's code.

A discount that applies to particular products is a line-level discount, and the Smart Cart renders that on the line item it applies to rather than in the summary. Shopify's Amount off products discount is the case merchants ask about most often, and because it lands on the line item it does not appear in the Order Discount Summary.

An applied gift card gets its own row in the summary and counts toward the number in the summary label, even though the label's default wording talks about discounts.

The summary label is the clickable line that tells shoppers how many order discounts are applied, and the Smart Cart uses a different one depending on the count. Each field appears once Order Discount Summary is on, which itself needs a Storefront API access token on your store and a visible Discount/Gift Card Code Input component with Use Storefront API turned on. Each field accepts HTML.

Each field accepts the {{discount_count}} placeholder, which the cart replaces with the number of rows in the breakdown. Use it once per field. As with the subtotal labels, the cart replaces the first {{discount_count}} in a label and leaves any later copy alone, so a second copy is shown to shoppers as raw text.

Because an applied gift card counts as a row, consider wording that covers discounts and gift cards alike. {{discount_count}} savings applied reads correctly whether the shopper has a discount code, a gift card, or one of each.

Free gifts added by the Tiered Progress Bar are left out of the subtotal figure the Smart Cart displays, without any setting or tag. Every other product in the cart is included in that figure.

There is no supported way to keep a regular product out of the subtotal the Smart Cart displays. A product's price is part of that figure whenever it is in the cart, and it is part of what Shopify charges at checkout either way.

For the product tags the Smart Cart reads, see Smart Cart Tags: Hide, Disable, and Exclude Cart Line Items.

The Advanced card at the bottom of the Cart Subtotal component holds the component's custom template controls. Turning on Enable Custom Template hands you the raw HTML for the subtotal area, so you own the markup instead of the label fields above. An Edit Code button appears beneath the toggle and opens the template editor, where you name the template and write its markup.

The Cart Subtotal component stores up to 10 custom templates, and the ones you replace stay available in the Previous Templates dropdown inside that editor. Once it is holding 10, Start New Template stops working and shows a Storage Limit Reached message, so delete a template from the dropdown to make room. See Smart Cart Custom Templates for how to write one.

A Smart Cart subtotal that is blank, or that disagrees with checkout, is nearly always something else on the page changing what the Cart Subtotal component renders rather than the component calculating the wrong figure. Work through it in this order.

Rebuy Support covers the settings on the Cart Subtotal component. The code inside a custom template or an Event Callback is written and maintained by you or your developer, and Support does not write, review, or troubleshoot it.

An Amount off products discount does not appear in the Order Discount Summary because the summary lists order-level discounts only. Rebuy builds the summary from the cart's order-level discount applications and from applied gift cards, and a product-level discount is applied to the line item instead, so it shows as a discounted price on that item rather than as a row in the breakdown. It still comes off the subtotal, so its absence from the breakdown is a display difference and not a discount that failed to apply. If nothing at all appears where you expect the summary, check its setup on each component: Use Storefront API has to be on for your Discount/Gift Card Code Input component, and Order Discount Summary has to be on for your Cart Subtotal component.

One discount is shown on the line item and another in the Order Discount Summary because the Smart Cart displays each discount where its scope puts it. Both kinds come off the subtotal, so this decides where a shopper sees the saving rather than whether they get it. A discount scoped to particular products is applied to those line items, so the Smart Cart shows it as a reduced price on each line it touches. A discount scoped to the whole order is applied across the cart, so the Smart Cart shows it against the subtotal and, when the Order Discount Summary is on, gives it a row in the breakdown. Whether a discount is applied automatically or entered as a code is not what decides this, since Shopify offers both automatic discounts and discount codes at either scope.

No, there is no setting or tag that keeps a regular product out of the subtotal the Smart Cart displays. A product's price is in that figure whenever the product is in the cart, and it is in what Shopify charges at checkout either way. A line discounted to zero adds nothing to the subtotal because it costs nothing rather than because it was excluded, and a free gift added by the Tiered Progress Bar is left out of the figure whatever it costs.

Keeping a product out of a Tiered Progress Bar threshold is a different thing, and that is supported. A threshold is the bar's own calculation rather than the figure the Cart Subtotal component displays, so excluding a product from a threshold changes when a tier unlocks and leaves the subtotal a shopper sees untouched. The bar offers a product picker and a Shopify product tag for this.

For the full setup see Smart Cart: Tiered Progress Bar Setup, and for the tag see Smart Cart Tags: Hide, Disable, and Exclude Cart Line Items.

Yes, an order discount comes off the subtotal the Smart Cart displays, so the figure a shopper sees is the amount after discounts rather than before them. This holds whether Shopify applied the discount automatically or the shopper entered it as a code in the cart. A product-level discount comes off the same figure through the line it applies to, and a gift card applied in the cart comes off it as well. Once any of those applies, the subtotal shows the discounted amount with the pre-discount amount struck through beside it.

The cart subtotal amount is available to code rather than to a placeholder, so it cannot be dropped into a text field. The Cart Subtotal component's label fields replace {{item_count}}, the summary label fields replace {{discount_count}}, and those are the only placeholders those fields recognize. Text like {{total_amount}} or {{cart_total}} is shown to shoppers exactly as typed, in these fields and in Tiered Progress Bar label fields alike. The Smart Cart renders in the browser rather than through Shopify's Liquid templates, so Liquid objects such as cart.total_price are not available to it either.

To put the amount into your own markup, read it in JavaScript. window.Rebuy.SmartCart.subtotalNumber() returns the figure the Cart Subtotal component displays, in cents, and window.Rebuy.Cart.cart.total_price returns Shopify's own cart total, also in cents. Inside a custom template for the Cart Subtotal component, the same values are available to your markup as subtotal() and subtotalLabel().

Code like this is yours or your developer's to write and maintain, and Rebuy Support does not build or troubleshoot it. Rebuy's AI Integration Guide is written to give a developer, or an AI coding assistant, the context it needs to build against Rebuy.