Eren Labs JOURNAL TR
WooCommerce Errors

“Usage limit for coupon has been reached” in WooCommerce: how uses are counted, and five causes

WooCommerce shows this when a coupon's per-coupon or per-customer limit is used up. The count includes more than paid orders, and open checkouts hold uses for a while, so here is exactly what counts.

In this article13 sections

This notice means the coupon has a usage limit and WooCommerce counts it as used up, either for the whole store or for this customer. WooCommerce checks this right after confirming the coupon exists, before dates or cart contents.

Two things push the count higher than most store owners expect: orders that were never paid or were refunded, and checkouts in progress that each hold a use for a while.

The exact message#

Usage limit for coupon “summer10” has been reached.

The same failure can also read:

  • Usage limit for coupon “summer10” has been reached. Please try again after some time, or contact us for help.
  • Usage limit for coupon “summer10” has been reached. If you were using this coupon just now but your order was not complete, you can retry or cancel the order by going to the my account page.
  • Coupon summer10 was used in another transaction during this checkout, and coupon usage limit is reached. Please remove the coupon and try again.
  • You have used this coupon summer10 in another transaction during this checkout, and coupon usage limit is reached. Please remove the coupon and try again.
  • “summer10” was removed from the cart. Usage limit for coupon “summer10” has been reached.
  • The “summer10” coupon has been removed from your cart: Usage limit for coupon “summer10” has been reached.
  • Sorry, it seems the coupon “summer10” is invalid – it has now been removed from your order.

Who sees it: Shoppers, after pressing Apply coupon, on classic and block carts. Guests usually meet a per-customer limit later, when they place the order, because WooCommerce needs their email first. The two “another transaction” wordings only appear after pressing Place order. The “my account page” wording is for logged-in shoppers on the classic cart and checkout; the block cart shows the plain sentence instead.

What WooCommerce checks#

Both limits are on the Usage limits tab of the Coupon data box:

  • Usage limit per coupon: how many times anyone can use it.
  • Usage limit per user: how many times one customer can use it. WooCommerce counts by account for logged-in customers and by billing email for guests.

A use is recorded when an order with the coupon moves to Pending payment, On hold, Processing or Completed. It is given back when the order moves to Cancelled or Failed, or to the trash. Refunding an order doesn’t give it back.

On top of that, each checkout placing an order with a limited coupon reserves one use. The reservation lasts for the Hold stock (minutes) setting under WooCommerce > Settings > Products > Inventory, at least one minute, or until the order is recorded, cancelled or fails. WooCommerce adds recorded uses and reservations together. When the total reaches the limit, the coupon is refused, and the wording tells you which situation you are in:

  • No reservations involved: the plain message.
  • Reservations involved, guest: “Please try again after some time, or contact us for help.”
  • Reservations involved, logged-in shopper with a pending or failed order: the link to the my account page.
  • Refused at Place order because the last use went to another checkout in the meantime: “used in another transaction during this checkout”.

Causes and how to fix each one#

1. The coupon really is used up#

The simplest case. The count has reached Usage limit per coupon, so nobody else can use it. The coupon list shows both numbers side by side.

Check: Go to Marketing > Coupons and read the Usage / Limit column, for example 100 / 100.

Fix: Raise Usage limit per coupon on the Usage limits tab, or clear it for unlimited use.

2. Unpaid or refunded orders are counted#

An order sitting in Pending payment or On hold has taken its use, and a refunded order keeps it. Only Cancelled, Failed and trashed orders give a use back. When stock management is on and Hold stock (minutes) is set, WooCommerce cancels unpaid checkout orders after that time, which frees their uses. Without that, an abandoned Pending payment order can hold a use indefinitely.

Check: If Usage / Limit is higher than the number of paid orders you expect, look through your Pending payment, On hold and Refunded orders for the coupon code.

Fix: Cancel unpaid orders that won’t be paid. For refunds, raise the limit by one per refunded order if those uses should count again.

3. Open checkouts are holding the last uses#

Every checkout placing an order reserves a use until it is paid or fails, or until the hold time runs out. During a busy launch the last few uses can all be reserved by shoppers who are still paying, or who closed the tab. The “try again after some time” and “my account page” wordings mean exactly this. A logged-in shopper gets the my account link whenever they have any Pending payment or Failed order, not only one with this coupon.

Check: Wait until the Hold stock (minutes) time has passed and apply the code again. If it works, reservations were the cause.

Fix: Lower Hold stock (minutes) if abandoned checkouts block real customers, or give limited launches a few spare uses.

4. This customer has reached their own limit#

Usage limit per user counts per customer. Logged-in customers are counted by account when they apply the code. Guests are counted by billing email, so their check runs when they place the order. At Place order WooCommerce also matches the customer’s account email and billing email, so an earlier guest order under the same email can count against a logged-in customer. On the classic checkout that case shows the “You have used this coupon … in another transaction” wording, even though the shopper isn’t doing two things at once. The checkout block removes the coupon with “… was removed from the cart” instead.

Check: Read Usage limit per user on the Usage limits tab, then look for earlier orders with this coupon from the same account or email address.

Fix: Raise the per-user limit if the customer should get another use. Otherwise the coupon is doing its job.

5. Two checkouts went for the last use#

The coupon was available when the shopper applied it, but the last use was taken or reserved by another checkout before they pressed Place order. That other checkout can be another customer, or the same shopper in a second tab or an earlier attempt that left an unpaid order. This is the “Coupon … was used in another transaction” wording.

Check: This wording appears only after pressing Place order. This wording appears only after pressing Place order. Usage / Limit may be at the limit, or below it while other checkouts still hold reservations.

Fix: The shopper can remove the coupon and order without it. If more people should get it, raise the limit.

Quick reference#

CauseHow to checkFix
The coupon really is used upGo to Marketing > Coupons and read the Usage / Limit column, for example 100 / 100.Raise Usage limit per coupon on the Usage limits tab, or clear it for unlimited use.
Unpaid or refunded orders are countedIf Usage / Limit is higher than the number of paid orders you expect, look through your Pending payment, On hold and Refunded orders for the coupon code.Cancel unpaid orders that won't be paid. For refunds, raise the limit by one per refunded order if those uses should count again.
Open checkouts are holding the last usesWait until the Hold stock (minutes) time has passed and apply the code again. If it works, reservations were the cause.Lower Hold stock (minutes) if abandoned checkouts block real customers, or give limited launches a few spare uses.
This customer has reached their own limitRead Usage limit per user on the Usage limits tab, then look for earlier orders with this coupon from the same account or email address.Raise the per-user limit if the customer should get another use. Otherwise the coupon is doing its job.
Two checkouts went for the last useThis wording appears only after pressing Place order. This wording appears only after pressing Place order. Usage / Limit may be at the limit, or below it while other checkouts still hold reservations.The shopper can remove the coupon and order without it. If more people should get it, raise the limit.

Reproduced on a test store#

We set up each case below on a clean WooCommerce 11.2.1 store on 6 November 2026 and recorded exactly what it showed.

What we didWhat WooCommerce showed
Coupon summer10, Percentage discount 10, Usage limit per coupon 1. One Completed order already used it (Usage / Limit shows 1 / 1). Simple product priced 20 in the cart, logged out. Apply summer10.Usage limit for coupon "summer10" has been reached. Please try again after some time, or contact us for help.
Usage / Limit: 1 / 1.
Same coupon. Change that order to Cancelled, then apply summer10 again.No message. The coupon was applied.
Usage / Limit: 0 / 1.
Same coupon, starting again from a Completed order at 1 / 1. Change the order to Refunded, then apply summer10.Usage limit for coupon "summer10" has been reached. Please try again after some time, or contact us for help.
Usage / Limit: 1 / 1.
Coupon held10, Usage limit per coupon 1, no orders. Add postmeta to the coupon with meta_key _coupon_held_{now+3600}_test and an empty value, the row WC_Coupon_Data_Store_CPT::check_and_hold_coupon writes. Logged out, apply held10.Usage limit for coupon "held10" has been reached. Please try again after some time, or contact us for help.
Same reservation row. Logged in as a customer who has one Pending payment order. Classic cart page, apply held10.Usage limit for coupon "held10" has been reached. If you were using this coupon just now but your order was not complete, you can retry or cancel the order by going to the my account page.
Same customer and reservation, applying held10 through the Cart block (Store API).Usage limit for coupon "held10" has been reached.
Coupon once10, Usage limit per user 1. A Completed guest order with billing email anna@example.com already used it. Logged out, classic checkout, apply once10, enter billing email anna@example.com and press Place order.Usage limit for coupon "once10" has been reached.

For developers#

To see the numbers WooCommerce adds together, run this in wp shell:

$c  = new WC_Coupon( 'summer10' );
$ds = $c->get_data_store();
var_dump( $c->get_usage_count(), (int) $ds->get_tentative_usage_count( $c->get_id() ), $c->get_usage_limit() );

Uses per customer are stored as _used_by rows on the coupon, holding a user ID or an email. Reservations are _coupon_held_* and _maybe_used_by_* rows whose key contains their expiry time, so they lapse on their own. Useful hooks: woocommerce_coupon_hold_minutes sets the reservation length, woocommerce_update_coupon_usage_invalid_statuses lists the order statuses that give a use back, and woocommerce_coupon_validate_user_usage_limit can switch off the per-user check when a logged-in customer applies the code. A third Place order wording, “An unexpected error happened while applying the Coupon …”, means the reservation query itself failed.

Where this lives in WooCommerce 11.2.1:

  • includes/class-wc-discounts.php, WC_Discounts::validate_coupon_usage_limit: Recorded uses plus reservations against Usage limit per coupon. Picks the plain, guest or my-account wording.
  • includes/class-wc-discounts.php, WC_Discounts::validate_coupon_user_usage_limit: Logged-in customers only: uses by user ID plus reservations against Usage limit per user.
  • includes/class-wc-cart.php, WC_Cart::check_customer_coupons: Guests: uses by billing email, checked during checkout validation.
  • includes/class-wc-coupon.php, WC_Coupon::get_coupon_error: Wordings for codes 106 (limit reached), 115 (stuck, logged in) and 116 (stuck, guest).
  • includes/abstracts/abstract-wc-order.php, WC_Abstract_Order::hold_applied_coupons / hold_coupon / hold_coupon_for_users: Reserves a use when the order is created and throws the two “another transaction” messages when it can’t.
  • includes/data-stores/class-wc-coupon-data-store-cpt.php, WC_Coupon_Data_Store_CPT::check_and_hold_coupon / get_tentative_held_time: Reservation rows and their lifetime: woocommerce_hold_stock_minutes, at least one minute, filterable with woocommerce_coupon_hold_minutes.
  • includes/wc-order-functions.php, wc_update_coupon_usage_counts: Records a use on pending, on-hold, processing and completed; gives it back on cancelled, failed and trash. Refunded is not hooked.
  • src/StoreApi/Utilities/OrderController.php, OrderController::validate_coupons / validate_coupon_usage_limit: Block checkout: per-customer check across user ID, billing email and account email, with the “was removed from the cart” wording.

Back to the WooCommerce error reference.

Frequently asked questions#


Do pending orders count towards a coupon's usage limit?

They can. An order with the coupon takes a use once it reaches Pending payment, On hold, Processing or Completed, and an order still being placed holds one for a while. Cancelling the order gives the use back.


Does refunding an order give the coupon use back?

No. Only orders that move to Cancelled or Failed, or to the trash, give a use back. A refunded order keeps it.


How does WooCommerce count usage per user for guests?

By billing email. Because a guest’s email isn’t known when they apply the code on the cart page, the check happens when they place the order.


Why does it say I used the coupon in another transaction when I didn't?

At Place order WooCommerce counts every use under your account and your email addresses, plus any reservation from an earlier checkout attempt. An old order under the same email, or an attempt that didn’t finish, is enough to reach the limit.


How long does WooCommerce hold a coupon during checkout?

For the Hold stock (minutes) setting under WooCommerce > Settings > Products > Inventory, at least one minute. The hold ends earlier when the order is recorded, cancelled or fails.


More in WooCommerce Errors

Keep exploring

All articles