Coupons & Promotion Codes

Discount and Coupon code rules

Time Period

Start Date

The start date specifies the date from when the discount applies. If no start date is specified, then the current date is assumed.

End Date

The end date determines the duration of the discount. If no end date is specified, the the discount is valid until deactivated.

Type of discount

A discount can take two forms, a flat amount or a percentage amount. A flat discount amount is applied to the target items starting with the cheapest items first, and is subject to a maximum target quantity limit. A percentage discount applies to all target items unless a maximum target quantity is specified, in which case it will apply to that number of target items starting with the cheapest items first.

Qualifying Conditions

In order for a code to be valid, it must meet the qualifying conditions. If no qualifying conditions are set, then the discount is applicable to the entire order, regardless of what is in the order.

Minimum Qualifying Quantity

If a minimum qualifying quantity is set, then there must be at least n qualifying items in the cart before the discount can be applied.

Minimum Qualifying Amount

If a minimum qualifying amount is set, then the value of all the qualifying items in the cart must be at least equal to the qualifying amount before the discount can be applied.

Discounts do not repeat

A discount is only ever applied once.

A discount of 10% for an order of $50 or more is only applied once. Even if the order is for $100, a discount of 10% is applied.

A discount of $5 for an order of $50 or more means that once an order has reached $50, then $5 is taken off the total of the qualifying items. If the order is for $100, the discount is still only $5. If you want the value of the discount to increase with the value of the order, then a percentage discount needs to be used. If you want step amounts for the discounts, then the orders would need to be split and ordered separately.

Qualifying Products

If no qualifying products are specified, then the qualifications apply to all products.

If a qualifying product collection is specified, then the qualification criteria apply only to products in that collection, and the qualifying requirements must be met by products from that collection before the discount applies, regardless of any other products in the cart.

Similarly, the qualifying products may be specified by Vendor or by Product Type, and the same qualifying rules apply as for a product collection.

Target Products

Once the qualifying conditions for a discount have been met, then the discount can be applied to a set of target products in the cart. The target products can be specified by product collection, vendor or product type. If no target products are specified, then the target is the same as the qualifying products.

For example, this allows you to offer discounts where the discount is limited to a set of special or bonus gift products.

Question: If we have a discount, say, "Spend $50 and get a bonus gift from collection X", then we can write a rule to apply a 100% discount to 1 item from collection X, but does the qualifying $50 limit include the cost of the item from collection X?

Maximum Target Quantity

If no maximum target quantity is specified, then the discount is applied to all target products.

If a maximum amount is specified, then the discount only applies to the first n cheapest target items in the cart.

As an example, this allows you to offer discounts like "Buy 3 for the price of 2". In this case a discount of 100% is created with a minimum quantity of 3 and a maximum target quantity of 1. As discounts do not repeat, if the customer purchases 6 items, they would still only get the cheapest for free.

Note: We may need a repeats option to allow a discount code to be repeatedly applied to a cart to take account of multiple purchases.