Restrict the usage of WooCommerce coupons unless required products are in the cart.
| Author: | runthings.dev (profile at wordpress.org) |
| WordPress version required: | 6.4 |
| WordPress version tested: | 6.9.1 |
| Plugin version: | 1.3.0 |
| Added to WordPress repository: | 22-02-2025 |
| Last updated: | 11-02-2026 |
| Rating, %: | 0 |
| Rated by: | 0 |
| Plugin URI: | https://runthings.dev/wordpress-plugins/wc-co... |
| Total downloads: | 657 |
 Click to start download |
|
This plugin allows you to restrict the usage of WooCommerce coupons unless specific products or variations are in the cart.
You can specify which products are required for a coupon to be valid, providing more control over your discount strategies.
Features
- Restrict coupon usage based on all required products (including variations) being in the cart.
- Customize the error message via a filter.
Filters
runthings_wc_coupons_required_products_missing_products
This filter allows third-party plugins to alter the missing required products before the coupon is rejected.
For detailed documentation and advanced examples, see the full documentation on GitHub.
Parameters:
$missing_products(array): The missing products in the cart, in the format[product_id => quantity].$coupon(WC_Coupon): The coupon object being validated.$required_products(array): The required products for the coupon, in the format[product_id => quantity].$cart_products(array): Products found in the cart, in the format[product_id => quantity].$cart(WC_Cart): The cart instance.
runthings_wc_coupons_required_products_error_message
This filter allows customization of the error message shown when a coupon is not valid due to missing required products.
For detailed documentation and advanced examples, see the full documentation on GitHub.
Parameters:
$message(string): The default error message, e.g.,"This coupon requires specific products in the cart.".$coupon(WC_Coupon): The coupon object being validated.$required_products(array): The required products for the coupon, in the format[product_id => quantity].$missing_products(array): The missing products in the cart, in the format[product_id => quantity].
License
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, see http://www.gnu.org/licenses/gpl-3.0.html.
Icon – Discount by Gregor Cresnar, from Noun Project, https://thenounproject.com/browse/icons/term/discount/ (CC BY 3.0)
Icon – restriction by Puspito, from Noun Project, https://thenounproject.com/browse/icons/term/restriction/ (CC BY 3.0)
Screenshots
FAQ
ChangeLog