Coupon by User Role for WooCommerce decides whether a coupon can be used based on the current customer’s roles. Understanding the order it uses helps you predict exactly who gets a discount and who does not.
The three controls that decide the outcome #
- Disable removes coupons entirely for a role: the coupon code field is hidden on the cart and checkout.
- Invalidate keeps the field visible but rejects the code for a role, showing your custom message.
- Amount by user role does not block anything: it changes the coupon’s value for a role.
Disable and invalidate can each be applied to all coupons (in the Availability section) or to one coupon (the per-coupon tabs). Per-coupon roles are added on top of the all-coupons roles.
How a role is matched #
A rule applies to a customer when they have at least one of the selected roles and none of the exception roles. Because a WordPress user can hold several roles at once, the exceptions field is what lets you keep an otherwise-blocked user eligible. Logged-out visitors are matched as the Guest role.
What the customer sees when a coupon is invalid #
When an invalidate rule matches, the coupon is rejected with the “Coupon is not valid” message from the Availability section. The message supports the %coupon_code% and %coupon_amount% placeholders and can contain HTML and shortcodes, including the multilingual translation shortcode. See customizing the message for details.
Standard coupon settings still apply #
Coupon by User Role sits on top of WooCommerce’s own coupon rules. A coupon still has to pass its normal checks (expiry date, usage limits, minimum spend, product and category restrictions) before the role rules are considered. If a coupon is not applying and no role rule is set, check the coupon’s standard WooCommerce settings first.
Free vs Pro #
All of this logic works in the free version for the eight standard roles. Pro extends role matching to every custom user role on your site. See the free vs Pro comparison.
Ready to set this up? #
To apply these rules to custom roles from a membership, wholesale, or B2B plugin, you need Coupon by User Role for WooCommerce Pro. Get Coupon by User Role Pro.
