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:
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.
-
WooCommerce7+ million installs
apply_filters( 'woocommerce_default_order_status', OrderStatus::PENDING )includes/abstracts/abstract-wc-order.php:697 -
WooCommerce Square80,000+ installs
apply_filters( 'woocommerce_default_order_status', 'pending' )includes/Framework/PaymentGateway/ApplePay/Payment_Gateway_Apple_Pay_Orders.php:58 -
Booster for WooCommerce30,000+ installs
apply_filters( 'woocommerce_default_order_status', 'pending' )includes/gateways/class-wc-gateway-wcj-custom-template.php:201 -
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 -
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 -
PeachPay300+ installs
apply_filters( 'woocommerce_default_order_status', 'pending' )core/abstract/class-peachpay-payment-gateway.php:545 -
Splitit for WooCommerce80+ installs
apply_filters( 'woocommerce_default_order_status', $default_order_status )classes/class-splitit-flexfields-payment-plugin-checkout.php:158 -
Marketplace Integration for Shopee & Lazada60+ installs
apply_filters( 'woocommerce_default_order_status', 'pending' )marketplaces/shopee/admin/shopee/lib/class-class-cedshopeeorders.php:557 -
CedCommerce Integration for Good Market50+ installs
apply_filters( 'woocommerce_default_order_status', 'pending' )admin/lib/class-ced-good_market-order.php:274 -
Simpler Checkout30+ installs
apply_filters( 'woocommerce_default_order_status', 'wc-processing' )includes/Services/OrderService.php:148 -
LazyChat20+ installs
apply_filters( 'woocommerce_default_order_status', 'pending' )includes/class-rest-api.php:1089 -
Terminal for Stripe and WooCommerce20+ installs
apply_filters( 'woocommerce_default_order_status', 'pending' )includes/admin/tfsw-stripe-terminal-ajax.php:444 -
Amwal Checkout10+ installs
apply_filters( 'woocommerce_default_order_status', 'pending' )includes/hooks.php:63 -
OnBuy Integration for WooCommerce10+ installs
apply_filters( 'woocommerce_default_order_status', 'pending' )admin/onbuy/partials/class-ced-onbuy-orders.php:391 -
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 -
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.