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.
- Visibility & content: Theme Settings → Cart → Cart announcement bar
- Tip: Keep the message under ~50 characters so it fits on one line on mobile.
Free-shipping progress bar
A horizontal bar that fills as the cart total approaches the free-shipping threshold.
- Threshold and messages: Theme Settings → Cart → Free shipping progress bar
- Disable the bar entirely: set the free-shipping amount to
0.
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:
| Element | Source |
|---|---|
| Empty cart heading | empty_cart_label |
| "Shop Now" button | Always shown — links to /collections/all |
| Extra button 1 | empty_cart_btn1_label + link (only shown if link is set) |
| Extra button 2 | empty_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.
- Cart has items: uses
upsale_headline(default:You might also like) - Cart is empty: uses
upsale_headline_best_sellers(default:Shop Best Sellers) - Products & order:
upsale_products— up to 5
Footer
| Element | Notes |
|---|---|
| Discount code field | DiscountCode Vue component. See Discount codes & gift cards. |
| Subtotal | Calculated from line items, excludes shipping and tax |
| "Checkout" button | Goes to Shopify checkout (/checkout) |
| Payment-method icons | Rendered 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:
| Situation | Message / state |
|---|---|
| Code accepted as a cart discount | Blue 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 otherwise | Red error: "The discount code you entered is invalid or cannot be applied to the items in your cart." |
| Request failed | Red 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:
- The line item is created with a
selling_planattached, so Shopify (and downstream ReCharge) know to recur it. - The cart drawer displays the selling plan name below the product title (e.g. "Delivered every 30 days").
- 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.