Skip to main content
Cartble’s discount system lets you create two kinds of savings rules: manual coupon codes that customers enter at checkout, and automatic promotions that apply to eligible carts without any customer action. Both are managed in Admin → Discounts & Coupons.

​
Discount methods

Manual coupon (code)

A specific code (e.g., VIP20, SUMMER50) that the customer types into the coupon field at checkout. The code is case-insensitive and trimmed automatically.

Automatic

Applied silently to the cart whenever the conditions are met. No code entry required — the discount appears automatically in the order total.

​
Creating a discount rule

Navigate to Admin → Discounts & Coupons and click New Discount.
1

Choose the method

Select Manual Coupon or Automatic. For manual coupons, enter the code you want customers to use or click Generate random code to create an 8-character alphanumeric code.
2

Set the discount type and value

Choose one of three discount types:
3

Define the scope

Control which products the discount applies to:
4

Add prerequisites (optional)

Set minimum requirements that must be met before the discount activates:
  • Minimum cart subtotal — the cart’s item total must reach this amount
  • Minimum item quantity — the customer must have at least this many items in their cart
5

Set usage limits

Control how many times the discount can be used:
6

Set the validity window

Enter a start date (required) and an optional end date. The discount is inactive outside this window. You can also use the active toggle to pause a discount manually at any time.

​
Discount statuses

A discount rule on the list shows one of four states:
Deleting an active discount removes it immediately. Any customer who tries to apply a deleted code will see an error at checkout.

​
How discounts are recorded on orders

When a customer redeems a discount, Cartble stores an appliedDiscount object on the order record. This includes the discount’s title, code (if applicable), type, method, and the exact amount deducted in cents — so your order history always reflects what was actually charged.

​
Tips for common scenarios

Create a manual coupon with type percentage, set One per customer to on, and leave the global limit at 0. Share the code in your welcome email.
Create an automatic discount with type free_shipping and set a minimum cart subtotal equal to your free-shipping threshold. No code required — it activates as soon as the cart qualifies.
Create an automatic discount scoped to a specific blueprint (e.g., “Subscription”), set the type to percentage, and use the start date and end date fields to define the sale window.
Create a manual coupon and set a global limit (e.g., 100). Once 100 customers redeem it, the code becomes exhausted automatically.