Skip to content

Pricing & Discounts

Coupons, Cart Rules & Pricing Engine

Last updated: May 15, 2026

How the Total is Calculated #

Step Component Description
1 Subtotal Sum of each line item (variant price × quantity)
2 Discount The larger of a manual coupon or a matching automatic cart rule is applied — they do not stack
3 Free shipping Applied when triggered by a free-shipping cart rule or when the subtotal meets the free shipping threshold
4 Shipping Zone and method-based fee
5 Tax Class and jurisdiction-based, applied before or after the discount depending on your tax settings
6 Grand total Subtotal − discount + shipping + tax

Coupon Codes #

Customers enter a coupon code at cart or checkout. Available coupon types:

  • Percentage — reduces the order subtotal by a percentage
  • Fixed amount — reduces the order subtotal by a set currency amount

Each coupon supports the following optional constraints:

  • Expiry date — the coupon is invalid after this date
  • Minimum cart value — the coupon only applies when the subtotal meets the minimum
  • Maximum total uses — the coupon can only be redeemed a set number of times in total
  • Maximum uses per customer — limits how many times a single customer can use the coupon

Automatic Cart Rules #

Cart rules apply automatically when their conditions are met — no code required.

Rule types:

  • Percentage discount
  • Fixed amount discount
  • Free shipping

Conditions:

  • Minimum cart value
  • Minimum item quantity
  • Specific product in the cart
  • Specific category in the cart

Rules are evaluated in priority order. The highest-priority rule that matches the cart wins. Only one rule is applied at a time — rules do not stack with each other or with coupons.

If both a coupon and a cart rule match, the larger discount is applied.

Free Shipping #

Free shipping can be triggered in two ways:

  1. Cart rule — create a free-shipping cart rule with whatever conditions you need (e.g. a specific product, a minimum quantity)
  2. Free shipping threshold — set a minimum order value in Checkout Settings (e.g. "free shipping on orders over $100"); free shipping is applied automatically when the subtotal meets or exceeds the threshold

Managing Discounts #

Navigate to Admin → Marketing → Coupons to create and manage coupon codes.

Navigate to Admin → Marketing → Cart Rules to create and manage automatic discount rules.