WordPress filter hook

woocommerce_default_order_status

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

“In view context, return the default status if no status has been set.”

How to use woocommerce_default_order_status

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

functions.php
add_filter( 'woocommerce_default_order_status', function( $default_order_status ) {
	// Change $default_order_status here.
	return $default_order_status;
}, 10, 1 );

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

16 plugins that fire woocommerce_default_order_status

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_default_order_status', OrderStatus::PENDING ) includes/abstracts/abstract-wc-order.php:697
  2. WooCommerce Square icon WooCommerce Square80,000+ installs apply_filters( 'woocommerce_default_order_status', 'pending' ) includes/Framework/PaymentGateway/ApplePay/Payment_Gateway_Apple_Pay_Orders.php:58
  3. Booster for WooCommerce icon Booster for WooCommerce30,000+ installs apply_filters( 'woocommerce_default_order_status', 'pending' ) includes/gateways/class-wc-gateway-wcj-custom-template.php:201
  4. Custom Payment Gateways for WooCommerce icon Custom Payment Gateways for WooCommerce8,000+ installs apply_filters( 'woocommerce_default_order_status', 'pending' ) includes/settings/class-wc-gateway-alg-custom-form-fields.php:115
  5. XL NMI Gateway for WooCommerce icon XL NMI Gateway for WooCommerce800+ installs apply_filters( 'woocommerce_default_order_status', 'pending' ) lib/skyverge/woocommerce/payment-gateway/apple-pay/class-sv-wc-payment-gateway-apple-pay-orders.php:63
  6. PeachPay icon PeachPay300+ installs apply_filters( 'woocommerce_default_order_status', 'pending' ) core/abstract/class-peachpay-payment-gateway.php:545
  7. Splitit for WooCommerce icon Splitit for WooCommerce80+ installs apply_filters( 'woocommerce_default_order_status', $default_order_status ) classes/class-splitit-flexfields-payment-plugin-checkout.php:158
  8. Marketplace Integration for Shopee & Lazada icon Marketplace Integration for Shopee & Lazada60+ installs apply_filters( 'woocommerce_default_order_status', 'pending' ) marketplaces/shopee/admin/shopee/lib/class-class-cedshopeeorders.php:557
  9. CedCommerce Integration for Good Market icon CedCommerce Integration for Good Market50+ installs apply_filters( 'woocommerce_default_order_status', 'pending' ) admin/lib/class-ced-good_market-order.php:274
  10. Simpler Checkout icon Simpler Checkout30+ installs apply_filters( 'woocommerce_default_order_status', 'wc-processing' ) includes/Services/OrderService.php:148
  11. LazyChat icon LazyChat20+ installs apply_filters( 'woocommerce_default_order_status', 'pending' ) includes/class-rest-api.php:1089
  12. Terminal for Stripe and WooCommerce icon Terminal for Stripe and WooCommerce20+ installs apply_filters( 'woocommerce_default_order_status', 'pending' ) includes/admin/tfsw-stripe-terminal-ajax.php:444
  13. Amwal Checkout icon Amwal Checkout10+ installs apply_filters( 'woocommerce_default_order_status', 'pending' ) includes/hooks.php:63
  14. OnBuy Integration for WooCommerce icon OnBuy Integration for WooCommerce10+ installs apply_filters( 'woocommerce_default_order_status', 'pending' ) admin/onbuy/partials/class-ced-onbuy-orders.php:391
  15. Ultimo Woocommerce Email Plugin icon Ultimo Woocommerce Email Plugin10+ installs apply_filters( 'woocommerce_default_order_status', 'pending' ) tools/woocommerce/payment-gateway/apple-pay/class-sv-wc-payment-gateway-apple-pay-orders.php:61
  16. TogetherPay for WooCommerce icon TogetherPay for WooCommerceFewer than 10 installs apply_filters( 'woocommerce_default_order_status', 'pending' ) class/WC_Gateway_SplitOff.php:2383

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.