---
title: WooCommerce Coupon Not Working — Test Black Friday Discount Codes Before Launch
description: WooCommerce coupon rejected at checkout? Match the error message to its cause, check expiry, spend limits, usage limits and caching, and test codes before peak.
source: https://pingvera.com/blog/woocommerce-coupon-not-working.html
---
# WooCommerce Coupon Not Working: Test Black Friday Discount Codes Before Launch

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.

## At a glance

- Coupons must be enabled under WooCommerce > Settings > General ("Enable the use of coupon codes"). If that box is unticked, no code works.
- WooCommerce's documentation says coupons "expire/cannot be used on the date that is set". A code meant to run through 30 November needs an expiry date of 1 December.
- Minimum and maximum spend are checked against the displayed cart subtotal, which includes tax when your cart shows prices including tax.
- Unfinished checkouts can hold a coupon's usage. A guest then sees "Usage limit for coupon ... has been reached. Please try again after some time, or contact us for help."
- WooCommerce says the Cart, Checkout and My Account pages must be excluded from page caching. A cached cart is a common cause of codes that seem to apply and then vanish.

## Why it matters now

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](https://pingvera.com/blog/update-woocommerce-safely.html) covers staging and rollback for the update itself.

## Step-by-step: find why a coupon is rejected

Work through these in order with a real cart on the live site, in a private browser window, logged out.

1. Get the exact message. Ask the customer for a screenshot, or reproduce it yourself. WooCommerce's core messages are listed in the table below. A message that does not match any of them usually comes from a plugin.
2. Confirm coupons are switched on. Go to WooCommerce > Settings > General and check "Enable the use of coupon codes". Someone may have unticked it after the last campaign.
3. Check the code itself. Open Marketing > Coupons and find the code. WooCommerce codes are not case-sensitive ("SAVE10" and "save10" both work), so case is not the problem. Look instead for a trailing space, a letter O typed as a zero, or a coupon still saved as a draft.
4. Check the expiry date. If the coupon expires on the last day of the promotion, it already stops working on that day. Set the expiry to the day after the last valid day, then test.
5. Check the spend range. Under Usage restriction, compare the minimum and maximum spend with the test cart. Remember the subtotal may include tax, depending on how your cart displays prices. Shipping is not a cart item, so it does not count towards the minimum.
6. Check product and category rules. Products, Exclude products, Product categories, Exclude categories and brand restrictions all narrow where the code applies. If "Exclude sale items" is ticked and every product in the campaign has a sale price, the coupon has nothing to discount. WooCommerce notes that a fixed cart discount can still apply when the cart also holds eligible items that are not on sale.
7. Check individual use. "Individual use only" blocks the code from combining with any other coupon. If an auto-applied coupon from a plugin is already in the cart, the customer's code fails.
8. Check allowed emails. "Allowed Emails" is verified against the customer's billing email, with wildcards such as `*@example.com`. A code restricted to a customer list fails for anyone who checks out with a different address.
9. Check usage limits. Under Usage limits, compare "Usage limit per coupon" and "Usage limit per user" with the usage count shown in the coupon list. Look for pending and failed orders that used the code: those checkouts can hold usage until they complete or are cancelled.
10. Check caching. Confirm your caching plugin, host cache and CDN exclude the Cart, Checkout and My Account pages, as WooCommerce's caching guide requires. Test with the cache bypassed. If the code works with no cache and fails with it, the cache rule is the fix.
11. Repeat after updates. Run steps 1 to 10 on staging after any WooCommerce, gateway or discount plugin update, and again on production after deployment.

## Match the error message to the cause

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.

## Copyable coupon test plan

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

Worked scenario (illustrative)
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.

## If your store runs on Shopify

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.

## Common mistakes

- Setting the expiry date to the last day of the promotion. The code stops working on that day.
- Copying last year's coupons without opening each tab. Old minimums, exclusions and email restrictions come along.
- Testing only while logged in as an administrator, with the cache bypassed. Customers see the cached, logged-out version.
- Testing the code but never placing an order. A code can apply in the cart and still produce wrong totals in the order or the confirmation email.
- Treating every complaint as a coupon setting problem. If the message matches no core wording, look at discount and checkout plugins first.

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](https://pingvera.com/blog/promotion-discount-validation.html) covers margin checks for the campaign as a whole.

## FAQ

### Are WooCommerce coupon codes case-sensitive?

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.

### Why does the coupon say the usage limit is reached when few orders used it?

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.

### Does the minimum spend include tax and shipping?

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.

## Sources

- WooCommerce, Coupon management: https://woocommerce.com/document/coupon-management/
- WooCommerce source, `class-wc-coupon.php` (error messages): https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce/includes/class-wc-coupon.php
- WooCommerce source, `class-wc-discounts.php` (expiry and spend validation): https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce/includes/class-wc-discounts.php
- WooCommerce Developer, How to configure caching plugins for WooCommerce: https://developer.woocommerce.com/docs/best-practices/performance/configuring-caching-plugins
- WooCommerce Developer, WooCommerce 11.3: What's coming for developers (26 October 2026): https://developer.woocommerce.com/2026/10/26/woocommerce-11-3-pre-release/
- WooCommerce Developer, Releases: https://developer.woocommerce.com/releases/
- Shopify Help Center, Discount combinations: https://help.shopify.com/en/manual/discounts/discount-combinations
- Shopify Help Center, Discounts FAQ: https://help.shopify.com/en/manual/discounts/discounts-faq

Last 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](https://pingvera.com/blog/woocommerce-checkout-monitoring.html) for how that fits with the checks above.
