Skip to content

Cart & Checkout ​

The cart experience is split between the cart drawer (slide-out shown when the cart icon is clicked) and the cart page (/cart). Both pull their content from the same Vue cart store, so they always stay in sync.

Almost every editable string in the cart lives in Theme settings → Cart — see Theme Settings → Cart for the full reference. This page focuses on what's on screen and how to change it.


Cart drawer (mini cart) ​

A slide-out panel attached to the cart icon in the header. Powered by the Cart Vue component.

Top: announcement bar (optional) ​

A small banner above the line items.

Free-shipping progress bar ​

A horizontal bar that fills as the cart total approaches the free-shipping threshold.

Line items ​

Renders each item in the cart (CartItem Vue component) with:

  • Product image
  • Title (links back to the PDP)
  • Line price + struck-through compare-at price
  • Quantity stepper (+/- buttons)
  • Remove (trash) button
  • Subscription items: a frequency dropdown listing the product's selling plans. Changing it switches the plan on the line itself.
  • One-time items of a subscribable product: a "+ Upgrade to subscription for free shipping" link that converts the line to the first selling plan.

Instant cart updates ​

The cart reacts immediately and talks to Shopify in the background, the same approach as on Super Snouts:

  • + / − / remove update the row and the totals at once. Fast repeated taps all count, and the row stays clickable while Shopify processes the change.
  • Add to cart (PDP, PLP card, cart upsell row) opens the drawer with the new line straight away, without waiting for Shopify. The PLP card's Add button shows no spinner.
  • Requests are queued and sent one at a time, so two quick changes to the same line can't race. A line that is still being added can already be incremented.
  • Changing the subscription frequency uses Shopify's /cart/change.js, so the line keeps its position and properties.
  • If Shopify rejects a change (e.g. not enough stock), the row rolls back to its previous state and an error toast appears. A "429 too many requests" error shows a Refresh page action.
  • Cart-level discounts are kept on the locally recalculated total until the server's totals arrive.

Implementation: src/vue/store/cart.js (queue + optimistic lines), src/utils/optimistic-line.js, src/services/cart.js.

Empty state ​

Shown when the cart has zero items. Includes:

ElementSource
Empty cart headingempty_cart_label
"Shop Now" buttonAlways shown — links to /collections/all
Extra button 1empty_cart_btn1_label + link (only shown if link is set)
Extra button 2empty_cart_btn2_label + link (only shown if link is set)
Upsell strip"Best Sellers" headline + upsale_products

Upsell strip ​

Carousel of suggested products at the bottom of the drawer.

ElementNotes
Discount code fieldDiscountCode Vue component. See Discount codes & gift cards.
SubtotalCalculated from line items, excludes shipping and tax
"Checkout" buttonGoes to Shopify checkout (/checkout)
Payment-method iconsRendered by snippet block-pay-methods.liquid

Discount codes & gift cards ​

The drawer and the cart page both have a Discount Code input with an Apply button (or press Enter). The code is applied through Shopify's /discount/<code> URL. What the shopper sees:

SituationMessage / state
Code accepted as a cart discountBlue pill with the discount title and an × to remove it
Code lowers the price but isn't a cart-level discount (e.g. a product discount)Pill with the code + grey note "Applied at checkout."
Code refused and it looks like a gift card (16 letters/digits)Grey note: "Gift cards are applied at checkout — enter this code in the “Discount code or gift card” field there." The field is cleared.
Code refused otherwiseRed error: "The discount code you entered is invalid or cannot be applied to the items in your cart."
Request failedRed error: "Please enter a valid coupon code."

The last applied code is remembered in the browser (localStorage key discountCode) and re-checked whenever the cart total changes. Clicking Apply keeps the drawer open.

Gift cards can't be redeemed in the cart

Shopify only redeems gift cards in checkout: neither /discount/<code> nor the cart API accepts them. The note tells the shopper where to enter the code instead of calling a valid card "invalid".

Checkout is hosted by Shopify

The theme stops at the Checkout button. The checkout itself is controlled in Shopify Admin → Settings → Checkout (not in the theme editor).


Cart page ​

Template: cart.jsonSection file: main-cart.liquid

The full-page version of the cart at /cart. Layout is the same as the drawer, but laid out as a full-page table. It uses the same Vuex store, CartItem rows and DiscountCode field as the drawer, so the frequency dropdown, the upgrade link, the discount messages and the instant updates behave the same way.

Section settings ​

The cart page section itself has no editable settings — all content reads from the same global cart settings in Theme Settings → Cart.


Checkout ​

Checkout is fully hosted and managed by Shopify. The theme does not customize the checkout pages. Configure it in:

  • Shopify Admin → Settings → Checkout — branding, customer accounts, shipping options
  • Shopify Admin → Settings → Payments — payment methods, express checkout
  • Shopify Admin → Settings → Shipping and delivery — shipping rates and zones

If you need a custom checkout extension (e.g. for upsells at checkout), it must be built as a Shopify Checkout UI Extension — not in this theme.

Checkout Savings extension is not wired up for Ark

Our Checkout Savings extension relies on the theme writing a _theme_id cart attribute and on a custom.shipping_cost metafield. The Ark theme does neither, so that extension has nothing to read on this store.


Subscription cart items ​

When a customer adds a Subscribe & Save product:

  1. The line item is created with a selling_plan attached, so Shopify (and downstream ReCharge) know to recur it.
  2. The cart drawer displays the selling plan name below the product title (e.g. "Delivered every 30 days").
  3. The price reflects the subscription discount.

After checkout, the subscription is owned by ReCharge — the customer manages it in their subscription portal, not in the theme.


Common content manager tasks ​

Change the free-shipping threshold ​

Theme Settings → Cart → Free shipping progress bar → Free shipping amount. Both the cart drawer and the cart page update.

Hide the in-cart announcement bar for a promo ​

Untick Theme Settings → Cart → Show announcement bar inside cart.

Swap the upsell products ​

Theme Settings → Cart → Upsell → Upsell products. The order in the list = the order in the drawer.

Add a quick "Build a Box" button to empty cart ​

Set empty_cart_btn1_label to Build a Box and empty_cart_btn1_link to the bundle page. The button appears only when the link is set.

Antelope Themes Documentation

Enter the password to access this site.