Better Coupon Restrictions

How can we help?

Search the documentation or ask the AI agent anything about the plugin.

What each coupon error message means

Updated September 15, 2026

When a Better Coupon Restrictions rule rejects a coupon, the shopper sees one of the default messages below, unless the coupon has a Custom Error Message for that section. Use this table to find the setting to check on the coupon’s Better Coupon Restrictions tab.

If the message is not in this list, it came from WooCommerce itself (for example “This coupon has expired.”) or from another plugin.

Product and cart messages

MessageRestriction to check
This coupon is not valid for your cart items.Improved Product Restrictions
This coupon is not valid for the categories in your cart.Improved Category Restrictions
This coupon is not valid for your cart item attributes.Product Attribute Restrictions
This coupon requires a minimum cart quantity / subtotal / weight of …Cart
This coupon cannot be used with the selected payment method.Allowed or Disallowed Payment Methods
This coupon cannot be used with the selected shipping method.Allowed or Disallowed Shipping Methods

Date and customer messages

MessageRestriction to check
This coupon is not currently available.Allowed Date Range, Allowed Calendar Months or Allowed Weekdays
This coupon is not available at this time of day.Allowed Time of Day
This coupon is only available to new customers.New Customer Only (on the coupon or globally)
This coupon is only available to logged in customers. / to guests.Customer Logged In Status
You do not have the required user role to use this coupon.Allowed Customer User Roles
Your user role is not allowed to use this coupon.Disallowed Customer User Roles

PRO messages

MessageRestriction to check
This coupon is not valid for your country. / state, city or province. / zip / postcode.Customer Address
This coupon has reached its usage limit.Maximum Usage Per Address or Maximum Usage Per IP Address
This coupon requires a minimum total spend on past orders / total past orders of …Customer Order History
This coupon is only available to registered customers.Time Registered (guest)
This coupon is only available within / after … hours after registration.Time Registered
This coupon is only available to customers with previous orders.Time Since Last Order
Sorry, you can not use this coupon.Referring Domain or IP Address lists (coupon or global)
This coupon is not valid for your account.Custom User Meta or Cookie
This coupon is not valid for the items in your cart.Custom Cart Item Meta
…email address from an approved domain. / not available for your email address.Customer Email
You have already used this coupon the maximum number of times for this period.Usage Limit Per Period
…customers who have previously purchased: …Purchase History
This coupon can only be applied through its link.Only Valid Via Link

Related

Was this article helpful?