WordPress filter hook

woocommerce_order_recalculate_coupons_coupon_object

Defined by WooCommerce and fired by 3 plugins in total, running on 7M+ sites between them.

“Allow developers to filter this coupon before it gets re-applied to the order.”

How to use woocommerce_order_recalculate_coupons_coupon_object

It's a filter: your callback receives the value and 3 more arguments, and must return the (changed) value. Add this to your theme's functions.php or a small custom plugin:

functions.php
add_filter( 'woocommerce_order_recalculate_coupons_coupon_object', function( $coupon_object, $coupon_code, $coupon_item, $object ) {
	// Change $coupon_object here.
	return $coupon_object;
}, 10, 4 );

Argument names come from WooCommerce's source. Other plugins may pass different values: check the call in the plugin you're targeting below.

3 plugins that fire woocommerce_order_recalculate_coupons_coupon_object

Sorted by active installs. Each entry shows where the plugin calls the hook and what it passes.

  1. WooCommerce icon WooCommerce7+ million installs apply_filters( 'woocommerce_order_recalculate_coupons_coupon_object', $coupon_object, $coupon_code, $coupon_item, $this ) includes/abstracts/abstract-wc-order.php:2080
  2. Gift Vouchers for WooCommerce icon Gift Vouchers for WooCommerce70+ installs apply_filters( 'woocommerce_order_recalculate_coupons_coupon_object', $coupon_object, $coupon_code, $coupon_item, $order ) includes/wgv_core/class-woocommerce-gift-vouchers-product-redemption-handler.php:982
  3. Briqpay for WooCommerce icon Briqpay for WooCommerce20+ installs apply_filters( 'woocommerce_order_recalculate_coupons_coupon_object', $coupon, $code, $coupon_item, $order ) includes/class-discount-lines.php:394

Need a customisation built on this hook?

Tell us what you want to change and which plugin it's for. We'll write it, test it and send it back as a small plugin.