The Complete Guide to WooCommerce Order Statuses (and How to Customize Them)
Understanding WooCommerce order statuses is fundamental to running a smooth online store. They tell you — and your customers — exactly where an order is in the fulfillment process.
But the default statuses don't always match every business model. In this guide, we'll cover what each status means and how to add custom ones.
Default WooCommerce Order Statuses
| Status | Description | |--------|-------------| | Pending Payment | Order received, awaiting payment | | Processing | Payment confirmed, order being fulfilled | | On Hold | Awaiting payment confirmation (bank transfer, etc.) | | Completed | Order fulfilled and delivered | | Cancelled | Cancelled by customer or admin | | Refunded | Order has been refunded | | Failed | Payment failed or was declined |
When Do You Need Custom Order Statuses?
Custom statuses are useful when your fulfillment process has unique stages that the defaults don't cover. Examples:
- "Ready for Pickup" — for local pickup orders
- "Out for Delivery" — for local delivery businesses
- "Awaiting Supplier" — for dropshipping stores
- "Partially Shipped" — for stores that ship items separately
How to Add Custom Order Statuses
Method 1: Using a Plugin (Recommended)
Plugins like custom order status managers let you create, rename, and reorder statuses without touching code. Look for one that also lets you:
- Set automatic email notifications per status
- Define which statuses count as "paid" for reporting
- Assign custom colors for quick visual identification in the admin
Method 2: Using Code
Add this to your child theme's
functions.php:
// Register custom order status function register_awaiting_supplier_order_status() { register_post_status('wc-awaiting-supplier', array( 'label' => 'Awaiting Supplier', 'public' => true, 'show_in_admin_status_list' => true, 'label_count' => _n_noop('Awaiting Supplier (%s)', 'Awaiting Supplier (%s)') )); } add_action('init', 'register_awaiting_supplier_order_status'); // Add to WooCommerce order statuses list function add_awaiting_supplier_to_order_statuses($order_statuses) { $order_statuses['wc-awaiting-supplier'] = 'Awaiting Supplier'; return $order_statuses; } add_filter('wc_order_statuses', 'add_awaiting_supplier_to_order_statuses');
Automating Status Transitions
Manually updating order statuses is time-consuming. Consider automating transitions:
- Auto-complete orders for virtual/downloadable products
- Auto-move to "Ready for Pickup" when your team marks it packed
- Send SMS or email alerts when status changes to "Out for Delivery"
Need more control over your WooCommerce order workflow? Explore our order management plugins designed to give store owners full visibility and control.
