
When a WooCommerce coupon is not working, the store almost always tells you why. WooCommerce rejects a code with a specific message: the code does not exist, it has expired, the minimum spend is not met, the usage limit is reached, the cart holds the wrong products, or the billing email is not on the allowed list. Read the exact message the customer saw, match it to the coupon setting behind it, and you have the cause in a few minutes.
The harder cases are the ones with no clear message: coupons switched off store-wide, a cached cart page, a code that expires a day earlier than the email promised, or a usage limit consumed by abandoned checkouts. Black Friday falls on 27 November 2026 and Cyber Monday on 30 November. Create your campaign codes now, test each one against an eligible and an ineligible cart, and repeat the test after any WooCommerce update you install before the freeze.
A broken campaign code fails in public. Customers paste it from your email, the store rejects it, and the complaints reach support while ad spend keeps running. The store stays up, so uptime checks stay green.
Two release items make a retest worthwhile this month. WooCommerce 11.2.2 shipped on 4 November 2026 as a security release, and its release summary lists "Store API and REST API hardening". The Store API is what the Cart and Checkout blocks use. WooCommerce 11.3 is scheduled for the week of 9 November 2026, according to the WooCommerce developer blog; as of 10 November, the releases page still lists 11.2.2 as the latest stable version. Neither release announces a coupon change, but any update that touches cart and checkout code is a reason to re-run your coupon tests.
WooCommerce 11.2 also changed one coupon rule. The documentation now says the minimum spend must be less than or equal to the maximum spend, and that existing coupons whose minimum is above their maximum "still enforce the stored minimum". If you copy last year's coupons, open each one and check both fields. Our guide on updating WooCommerce safely covers staging and rollback for the update itself.
Work through these in order with a real cart on the live site, in a private browser window, logged out.
*@example.com. A code restricted to a customer list fails for anyone who checks out with a different address.These are WooCommerce core messages from the WC_Coupon and WC_Discounts classes, with the setting to check. Plugins and themes can change the wording.
| Message the customer sees (core wording) | Likely cause | Where to check | Owner |
|---|---|---|---|
| Coupon "X" cannot be applied because it does not exist. | Typo, draft or trashed coupon, wrong store | Marketing > Coupons | Marketing |
| Coupon "X" has expired. | Expiry set to the last valid day, or campaign dates wrong | General tab, Expiry date | Marketing |
| The minimum spend for coupon "X" is ... | Cart below minimum, tax display changes subtotal | Usage restriction, Minimum spend | Marketing |
| The maximum spend for coupon "X" is ... | Cart above maximum | Usage restriction, Maximum spend | Marketing |
| Sorry, coupon "X" is not applicable to your cart contents. | Product or category rules exclude the cart | Usage restriction, products and categories | Marketing |
| Sorry, coupon "X" is not valid for sale items. | "Exclude sale items" with discounted products | Usage restriction | Marketing |
| Sorry, coupon "X" has already been applied and cannot be used in conjunction with other coupons. | "Individual use only" plus another coupon | Usage restriction, other active coupons | Developer |
| Please enter a valid email to use coupon code "X". | Billing email not on the allowed list | Usage restriction, Allowed emails | Marketing |
| Usage limit for coupon "X" has been reached. | Limit reached, or held by unfinished checkouts | Usage limits; pending orders | Store manager |
Paste this into your campaign ticket. Run it on staging first, then on production after the coupons go live but before the email is sent.
WooCommerce coupon test plan (run per code, before announcing)
Code: ____________ Campaign dates: ______ to ______ Tester: ______
Settings review
[ ] Coupons enabled (WooCommerce > Settings > General)
[ ] Coupon status: Published
[ ] Discount type and amount match the campaign brief
[ ] Expiry date = day AFTER the last valid day
[ ] Minimum spend <= maximum spend (or one left empty)
[ ] Product / category / brand rules match the brief
[ ] "Exclude sale items" decision agreed with marketing
[ ] "Individual use only" decision agreed (auto-applied coupons?)
[ ] Allowed emails empty unless the code is private
[ ] Usage limit per coupon / per user / X items match the brief
Live tests (private window, logged out, cache not bypassed)
[ ] Eligible cart: code applies, discount amount correct
[ ] Cart below minimum spend: rejected with minimum spend message
[ ] Ineligible product only: rejected
[ ] Code in lower case: applies
[ ] Code combined with a second coupon: behaves as agreed
[ ] Full order placed with real payment method, then refunded
[ ] Order shows coupon line and correct totals in admin and email
[ ] Same tests on mobile, Cart block and Checkout block
After any WooCommerce or plugin update before the campaign
[ ] Re-run the eligible cart and below-minimum tests
An agency maintains a WooCommerce store that plans a "BF25" code for 25% off from 27 to 30 November. The marketing manager copies last year's coupon, changes the code and sets the expiry date to 30 November. Last year's coupon also had "Exclude sale items" ticked and a minimum spend of 50, entered when the store showed prices excluding tax.
The agency runs the test plan on 18 November and finds three problems. The campaign also puts the hero products on sale, so "Exclude sale items" leaves nothing to discount. A cart of 45 plus tax passes the minimum, because the store now displays prices including tax. And the expiry date would have ended the code on Cyber Monday itself. The manager unticks "Exclude sale items" after agreeing the margin impact, raises the minimum and moves the expiry to 1 December. The retest passes. The numbers are invented for illustration.
Shopify's help center says discounts do not combine unless each discount is configured to allow it, and a customer can use at most five product or order discount codes and one shipping discount code per order. An unfinished checkout can also hold a code at its usage limit. "Enter a valid discount code" means the code does not exist or is not active. The same eligible and ineligible cart tests apply.
This checklist does not cover the rules and messages that discount plugins, B2B pricing tools and custom code add. A coupon that passes every test can also fail later, when a gateway or cache configuration changes. Our article on promotion and discount validation covers margin checks for the campaign as a whole.
No. WooCommerce's documentation states that "SAVE10" and "save10" both work. If a code fails only for some customers, check for spaces, similar-looking characters and email restrictions instead.
Unfinished checkouts can hold a coupon's usage. WooCommerce shows a specific message for this case and, for logged-in customers, points them to their account page to retry or cancel the order. Check pending and failed orders that carry the code.
WooCommerce uses the displayed cart subtotal, which includes tax when your cart displays prices including tax. Shipping is not a cart item and does not count.
class-wc-coupon.php (error messages): https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce/includes/class-wc-coupon.phpclass-wc-discounts.php (expiry and spend validation): https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce/includes/class-wc-discounts.phpLast reviewed: 10 November 2026
A coupon test catches the problems you thought to check. During the campaign itself, Pingvera's WordPress connector sends WooCommerce order events, and its anomaly detector compares order flow with an hourly baseline and alerts when the site is up but orders have stopped. If a broken code or checkout change stalls sales on Black Friday morning, you find out from the alert rather than from customer emails. See WooCommerce checkout monitoring for how that fits with the checks above.
Pingvera watches whether an online business actually works — uptime, checkout, orders, domain, SSL and server — and alerts you in Telegram, email or a webhook before a customer has to tell you.
Start freeRead next: How to Update WooCommerce Safely Before Black Friday · Website Stress Test Before Black Friday: Store Plan · Card Testing Attack: Detect and Stop It Before Black Friday · Update PHP on WordPress: WooCommerce Plan Before 11.6 · Run a free site check.
Read next: WooCommerce 11.3: What to Test Before Black Friday · How to Update WooCommerce Safely Before Black Friday · Website Stress Test Before Black Friday: Store Plan · Card Testing Attack: Detect and Stop It Before Black Friday · Run a free site check.