Advanced Discounts documentation
Build multi-tier Craft Commerce discounts with flexible rules and promotional messages, alongside Commerce’s own discounts rather than in place of them.
Where to go#
First time here? Start with Installation, then follow a recipe end to end.
Running promotions day-to-day? See the user guide:
- Discounts, creating a discount and structuring it into groups.
- Cart Conditions, the rules that decide when a discount applies.
- Cart Actions, what happens once those rules match.
- Coupon Codes, gating a discount behind a code, in bulk or one at a time.
- Messages, promotional copy shown to the customer, with dynamic tokens.
- Troubleshooting, why a discount isn’t applying, and how the plugin sits alongside Commerce’s own discounts.
Building on top of the plugin? See the developer guide and reference:
- Displaying promotional messages, the Twig API for rendering discount messages in your storefront.
- Reading discounts on the order, breaking a total discount down into the rules that produced it.
- Adding a discount type, extending the plugin with a type of your own.
- Events and Permissions, for looking things up.
Want a worked example? See the recipes:
- Site-wide coupon, 10% off everything behind a coupon code.
- Timed product discount, 5% off a group of products for one week.
- Buy one, get one free, a Buy X, Get Y promotion.
- Tiered sale, spend more, save more, with dynamic messaging.
Also useful: Excluded Variants, the products no discount can touch.