Documentation

Cart blocks: line items, reward tiers, upsells and checkout

Every block of the Story Theme cart drawer, cart page and added-to-cart popup, with their settings, display rules and real examples.

The Story Theme cart is made of blocks, just like a page: line items, reward tiers bar, upsells, gift wrap, discount code, order summary, checkout button… You choose which ones to show, in what order, and even under which conditions.

A demo's cart drawer, block by block: reward tiers, item, delivery estimate, shipping estimate, gift wrap, note, preferred date, upsells and order summary
A demo's cart drawer, block by block: reward tiers, item, delivery estimate, shipping estimate, gift wrap, note, preferred date, upsells and order summary

Where to find these blocks

The cart comes in three forms, chosen in Theme settings > Cart > Cart type: Drawer (the default), Page or Popup notification. Each one has its own section and zones:

CartWhere to set it upZones that accept blocks
DrawerEdit theme, any page > Cart drawer sectionHeader, Content, Footer, Empty cart
Cart pageEdit theme > Cart > Cart sectionMain column, Summary column, Empty cart
Added to cart popupEdit theme > Added to cart popup sectiondirectly in the section
  1. Open the section for the cart you want, then expand a zone (for example Content).
  2. Click Add block: the Cart category lists the blocks for this page; zones also accept generic blocks (Group, Heading, Text, Image, Button, Badge, Checklist, Countdown, Trust badges, Payment icons, Accordion, Liquid, apps).
  3. Drag the block into place, then click Save.
Screenshot to take — Theme editor > any page > Cart drawer section selected (drawer open in the preview): Header, Content and Footer zones expanded in the sidebar, Add block button of the Content zone visible

All section settings (width, position, floating style, open after adding…) are covered in Cart page and cart drawer sections.

What all cart blocks share

On top of their own settings, every cart content block has two groups of settings:

  • [Appearance] Background (Default, Color, Gradient, None), Text, Highlight, Corners, Inner spacing, Text size, Show a border, Full width, Stick to the edge of the zone, space above and below.
  • [Display rules] Show this block: Always, Only when the conditions are met, or Except when… Available conditions: Cart total from / Cart total below, At least this many items, Customers (Everyone, Logged in, Not logged in), Customer tags, Countries, Markets, Cart contains one of these products, Cart contains a product from these collections. Every condition you fill in must be met.

The zones

  • Header (drawer): Show title and Title, Show item count, Close button (Icon, Round, Text), Link to the cart page, Link to the wishlist, Hide these blocks when the cart is empty. Accepts reward tiers, timers and messages, among others.
  • Content (drawer): margins, space between blocks, color palette.
  • Footer (drawer): Keep at the bottom (on by default: the total and checkout button stay visible while the items scroll), Shadow above, Show divider.
  • Main column and Summary column (page): the latter has a Style (Card / Plain) and Keep visible while scrolling.
  • Empty cart: see below.
The drawer header: "Your cart" title, item count, link to the cart page and close button
The drawer header: "Your cart" title, item count, link to the cart page and close button

Line items

The list of products in the cart.

Line items on the Softy demo cart page: a free gift, a product with an editable color, another with its savings badge and two dropdowns (size, color)
Line items on the Softy demo cart page: a free gift, a product with an editable color, another with its savings badge and two dropdowns (size, color)
  • [Image] Image width, Image ratio, Image fit, Link to the product page.
  • [Content] Show vendor, Show the SKU, Title size, Variant options (Editable lists: customers change their size or color without leaving the cart; With labels; On one line; Hidden), Show personalisation fields, Show subscription name, Let customers change their subscription, Gift badge, Hide checkbox products from the list, Low stock alert.
  • [Price] position and size, Show compare-at price, Show unit price, Show savings badge (Percentage / Amount, text and colors).
  • [Controls] Show quantity selector and its style (Outline, Rounded, Solid), Remove button (Icon, Text, Hidden), Offer to undo a removal.
  • [Layout] Order, space between items, dividers, Show column headings (cart page).
A line item with its "€8.00 saved" badge and the discount code applied
A line item with its "€8.00 saved" badge and the discount code applied

Cart title

For the cart page: Title, Heading level (H1 by default), Title size, Heading style, Alignment, Show item count, Show continue shopping link.

Rewards progress

A bar that shows progress toward free shipping, a discount or a gift, and can add the gift automatically.

Three tiers on the Softy demo: free shipping at €39, free plush toy at €59, free bowl at €89, with the plush toy added to the cart
Three tiers on the Softy demo: free shipping at €39, free plush toy at €59, free bowl at €89, with the plush toy added to the cart
A plainer bar with a single tier, free shipping, and no labels under the bar
A plainer bar with a single tier, free shipping, and no labels under the bar
  • Progress based on (Cart subtotal / Number of items), Count only one collection, Don't count gifts and add-ons.
  • [Tier 1] to [Tier 4]: Threshold (0 turns the tier off), Reward (Free shipping, Discount, Free gift, Other), Label, Icon, Color once reached, Gift products (added automatically at the threshold, removed below it; with several products, the customer chooses).
  • [Messages] Progress message ([amount], [reward]), Message once everything is unlocked, alignment.
  • [Progress bar] Display (Bar with labels, Bar with icons, Minimal bar, Message only), Show thresholds, Style, thickness, colors, Unlock animation (Bounce, Glow, None), Hide the bar once every tier is reached.
  • [Other currencies] Thresholds per currency (for example USD:60,120;GBP:50,100).

Upsells

Products customers can add in one click from the cart. Two presets: Upsells and Compact recommendation (better suited to the drawer's sticky footer).

Upsells in a carousel on the Softy demo: cards with image, price and "Add" button
Upsells in a carousel on the Softy demo: cards with image, price and "Add" button
  • Title, size and alignment; Source (Shopify recommendations, Collection, Chosen products, Product metafield); Recommendation type (Complementary then related, Complementary, Related); fallback Collection; Metafield (custom.cart_upsells by default); Number of products; Hide products already in the cart.
  • Presentation: Layout (Carousel, List, Grid), Visible cards and Visible cards on wide spaces, Auto-scroll every, Style, image ratio and fit, Show variant selector, Show compare-at price, Discount badge, button text, style and size.

Complementary products are set in Shopify's Search & Discovery app. See Cart upsells.

Checkbox product

An option customers turn on in one tap: gift wrap, shipping protection.

A checkbox product with a switch: "Gift wrap" and its description
A checkbox product with a switch: "Gift wrap" and its description
The same option as a checkbox with its price, "+€3.00"
The same option as a checkbox with its price, "+€3.00"
  • Type: Product (adds a real line to the cart) or Cart attribute (saves a yes or no on the order, under an Attribute name).
  • Product (use a product with a single variant, hidden from your collections if needed), Title, Description, Show price, Show variant selector, Pre-selected.
  • Control (Switch / Checkbox), Visual (Icon, Product image, Custom image, None), Style (Card / Plain).

Order note and Order field

The Order note is free text from the customer (a message, a delivery instruction). The Order field asks for a specific piece of information, saved on the order under its own name.

An order note and an order field, both collapsed: "A note to slip in the parcel" and "Preferred delivery date"
An order note and an order field, both collapsed: "A note to slip in the parcel" and "Preferred delivery date"
  • Order note: Display (Collapsed, Open by default, Always visible), Title, Icon, Placeholder, Height (lines), Maximum length.
  • Order field: Field (Short text, Long text, Dropdown list, Date, Checkbox), Attribute name (shown on the order), Title, Icon, Choices (comma-separated), earliest and latest dates, Days that cannot be chosen (Sundays, Weekends), Help text, Required (blocks checkout while the field is empty), Display.

Discount code

The field where customers enter their promo code.

The discount code open on the Lumyx demo: "Promo code" field and "Apply" button
The discount code open on the Lumyx demo: "Promo code" field and "Apply" button
  • Display (Collapsed by default, Open by default, Always visible), Title, Icon, Placeholder, Button text, Button style.

Shipping estimate

Customers pick a country, a region and a postal code to see your shipping rates.

The shipping estimate collapsed: "Estimate shipping"
The shipping estimate collapsed: "Estimate shipping"
  • Title, Icon, Display (Collapsed, Open by default, Always visible), Ask for the postal code, Layout (Stacked / Postal code and button on one line), button text, style, width and size.

Delivery estimate

Shipping and delivery dates, calculated the same way as the Delivery date block on the product page.

The delivery estimate in the drawer: ordered, shipped, delivered, with dates
The delivery estimate in the drawer: ordered, shipped, delivered, with dates
  • [Display] Style (Card / Plain), Layout (Steps / One line), Icon style.
  • One step per label and icon, then [Dates]: Days to prepare order, shortest and longest delivery times, Don't count weekends, Closed days, Cut-off time, Show the time left before the cut-off, Date format.

Cart countdown

Counts down to a real deadline: the end of an offer, or today's shipping cut-off time.

A countdown at the top of the drawer on the Lumyx demo: "Launch offer: ends in" with days, hours, minutes and seconds
A countdown at the top of the drawer on the Lumyx demo: "Launch offer: ends in" with days, hours, minutes and seconds
  • Count down to: A date and time (End date in YYYY-MM-DD format, End time) or A cut-off time every day (Cut-off time, Monday to Friday only).
  • Text ([timer]), When it ends (Hide the timer / Show a message), Timer style (Cards, Outline, Inline with labels, Minimal), digit size and colors, unit labels, Style (Banner / Plain), Icon.

The time is your store's time, the same for every visitor.

Reservation timer

A countdown of a few minutes, per visitor, such as "Your cart is reserved for [time]".

Screenshot to take — Test store: cart drawer with one item, Reservation timer block in the Header, Banner style, countdown running (10 min)
  • Text ([time]), Duration (1 to 60 min, 10 by default), Restart when a product is added, When it ends (Show a message, Start again, Hide the timer), Message once it ends, Style, Icon.

The timer never empties the cart: when it ends, the items stay where they are.

Urgency message

A message based on real stock, a metafield or a number.

An urgency message as a banner on the Lumyx demo: "Only 7 left in stock: Lumyx Halo"
An urgency message as a banner on the Lumyx demo: "Only 7 left in stock: Lumyx Halo"
  • Show when: An item is running low (with Running low at or below), A product has a number in its metafield (Product metafield, for example custom.recent_sales), The cart holds a product with untracked stock, or Always.
  • Text for each case ([quantity], [count], [product]), Minimum random number / Maximum random number for [nbr], Style, Icon.

You create the recent sales metafield and keep it up to date yourself (Shopify Flow or an app). A random number isn't tied to anything: only use it for an honest message. See Cart messages and reassurance.

Savings banner

Reminds customers how much they're saving.

  • Text ([amount], [percent]), Savings format (Amount / Percentage), Show from, Style (Banner / Plain), Icon.

Terms checkbox

A checkbox before checkout, for example "I agree to the terms and conditions".

Screenshot to take — Test store: cart drawer footer with the Terms checkbox block above the Checkout buttons, after clicking the button without checking the box (error message visible)
  • Text (can include a link to your terms), Error message, Remember the choice (the box stays checked for the rest of the visit).

Checkout stays blocked until the box is checked.

Order summary

The Order summary block groups the total lines. The preset contains Subtotal, Order discounts, Total and Total savings; you can add the others.

The order summary and checkout button in the drawer footer: subtotal, shipping calculated at checkout, total, and "Proceed to checkout" with the amount
The order summary and checkout button in the drawer footer: subtotal, shipping calculated at checkout, total, and "Proceed to checkout" with the amount

The lines (each with Line above):

  • Subtotal: Label.
  • Order discounts: Only show when there is a discount.
  • Shipping: Label and Shipping text.
  • Total: Label, Show item count, Show currency code.
  • Total savings: Label, Only show when there are savings.
  • Taxes and shipping note and Installments: Alignment.
  • Custom text: free Text and its alignment.

Checkout buttons

The button that leads to checkout, along with express checkout.

  • Text above the button (alignment, size), Button text, Second line (for example "Secure checkout"), Button style, Button size, Button width (Fill / Fit content), Icon (Lock by default, Arrow…).
  • Show total in the button, Show express checkout (Shop Pay, Apple Pay, Google Pay or PayPal if they're turned on in your payment settings), Show view cart link, Show continue shopping link.

Empty cart

What customers see when their cart is empty: an icon, a title, a text and a button, followed by any blocks you choose (upsells, reward tiers, product list, collection list…).

The empty cart on the Havn demo: bag icon, "Your cart is empty" and "Continue shopping" button
The empty cart on the Havn demo: bag icon, "Your cart is empty" and "Continue shopping" button
  • Icon, size, color and Circle behind the icon; Title and its size; Text; Show button, Button text, Button link, Button style; Show login link; Alignment and Center vertically.

In the editor, check Preview empty cart on the section to work on this state without emptying your cart.

The added-to-cart popup

With the Popup notification cart type, a window confirms the item was added. It also accepts blocks (reward tiers, upsells, checkbox product, timers, delivery estimate, savings, urgency, product list…), placed according to Blocks position: under the title, above or under the buttons.

The added-to-cart popup on the Narvo demo: added product, subtotal, free shipping bar, two upsells and the Checkout and View cart buttons
The added-to-cart popup on the Narvo demo: added product, subtotal, free shipping bar, two upsells and the Checkout and View cart buttons

Learn more