Skip to content

Promotions & coupon codes

Promotions are how every discount in your store is expressed — the automatic “free shipping over €50”, the newsletter code, the three-for-two, the trade ladder, the end-of-season sale on one category. They all live on one screen at Marketing → Promotions, and the only thing that makes a discount a coupon is whether you fill in the Code field.

Plans: All plans

  • Nothing for the basic types. Order discounts and free shipping are base features on every plan.
  • For product discounts, Buy X get Y, volume pricing and catalog sales: a plan that includes marketing.promotions.advanced.
  1. Go to Marketing → Promotions and add a promotion.

  2. Give it a Title. This is what you and your staff see; it is not shown to shoppers.

  3. Decide whether it needs a Code.

    • Leave it blank for an automatic promotion that applies to every qualifying order.
    • Fill it in — SUMMER10 — to make it a coupon the shopper must type at checkout.
  4. Pick the Type (the promotion class) and the Discount method, then enter the Value.

  5. Set the limits and window you want — minimum subtotal, dates, usage caps.

  6. Set the Status to Active when you want it live, or Scheduled with a start date.

  7. Save.

Type What it discounts Plan
Amount off order The order total All plans
Free shipping The shipping line All plans
Amount off products Only the lines in scope Advanced
Buy X get Y Y items once X are bought Advanced
Volume pricing Per-unit price by quantity tier Advanced
Catalog / collection sale A whole category or collection Advanced

Discount then says how the value is read: Percentage, Fixed amount, Fixed price or Free shipping. Buy X get Y and volume pricing use their own pair — “% off” or “Amount off” — on the quantity they apply to.

Three fields drive it: Buy quantity, Get quantity and Get discount. Three-for-two is buy 2, get 1, get discount 100%. Half price on the second item is buy 1, get 1, get discount 50%.

Add quantity tiers: a minimum quantity, a discount method and a value, one row per step. Add tier for each break. This is the retail equivalent of a B2B price ladder — the difference being that a promotion applies to everybody, while a price list applies to one company.

Field Effect
Title Internal label
Code Blank = automatic; filled = a coupon the shopper enters
Status Draft, Scheduled, Active, Paused or Ended
Type The promotion class — see the table above
Discount Percentage, Fixed amount, Fixed price or Free shipping
Value The number the discount method reads
Buy quantity / Get quantity / Get discount Buy X get Y only
Quantity tiers Volume pricing only: min qty, discount, value
Starts at / Ends at The window in which it applies
Min subtotal The order must reach this before it applies
Min quantity The order must contain this many items
Max discount Caps the discount given — essential on percentages
Total uses limit Redemptions across the whole store
Per-customer limit Redemptions per shopper
Stack group Order, Product or Shipping
Limit to category IDs Comma-separated category IDs; blank applies store-wide
First order only New customers only
Logged-in customers only Excludes guest checkout
Apply only to scoped lines Discounts only the lines in scope, not the order

By default a promotion applies store-wide. Limit to category IDs narrows it — enter the IDs comma-separated, for example 3, 7, 12. Leaving the field blank applies it everywhere.

Apply only to scoped lines then decides what the discount is calculated on: with it ticked, only the matching lines are discounted; without it, the whole order is, as long as it contains a matching line.

Each promotion sits in a stack group — Order, Product or Shipping — and at most one promotion applies per group. So an order-level discount and free shipping can combine, but two order-level discounts cannot. This is deliberate: it is what stops two independently sensible campaigns from discounting the same order twice.

Status Behaviour
Draft Not live; nothing applies
Scheduled Becomes active at Starts at
Active Live now
Paused Temporarily off, keeping its settings and counts
Ended Finished

Pause rather than delete when a campaign stops. The promotion keeps its redemption count, which is the only record of what the campaign actually cost.

Each promotion’s row carries its own analytics: how many times it was redeemed and how much discount it gave in total. Read both together — a high redemption count with a large discount total on a code with no usage cap is the pattern worth catching early.

The promotion does not apply. Check in this order: Status is Active, the current date is inside Starts at/Ends at, the order meets Min subtotal and Min quantity, and no other promotion in the same stack group has already applied.

A coupon code is rejected. The Total uses limit or Per-customer limit has been reached, or First order only is on and the shopper has ordered before, or Logged-in customers only is on and they are checking out as a guest.

A percentage discount gave away far too much. Max discount was blank. Set a cap on every percentage promotion.

The discount hits the wrong lines. Limit to category IDs is blank, or Apply only to scoped lines is not set.

Two discounts should combine but do not. They are in the same stack group. Move one to a different group, if that is genuinely what you want.

An advanced type is not available. Product discounts, Buy X get Y, volume pricing and catalog sales need Retail, Business or Enterprise.

What is the difference between an automatic promotion and a coupon? The Code field. Leave it blank and the discount applies by itself to every qualifying order; fill it in and the shopper must enter that code at checkout. Everything else about the promotion works the same way.

Is there a separate coupons screen? No. A coupon is a promotion with a code, created on the same screen under Marketing → Promotions.

Can two promotions apply to one order? Only across different stack groups. Stack groups are Order, Product and Shipping, and at most one promotion applies per group — so an order discount and free shipping can combine, but two order discounts cannot.

How do I stop a promotion being abused? Use the three limit fields: Total uses limit caps redemptions across the store, Per-customer limit caps them per shopper, and First order only restricts it to new customers.