Sébastien Laframboise

Understanding WooCommerce order statuses and when to change them

Understanding WooCommerce order statuses and when to change them

Regular WooCommerce order statuses indicate the actual state of each sale: payment, fulfillment, shipping, cancellation, or refund. They’re not just for sorting the orders list. They also affect team workflow, transactional emails, and, depending on settings, inventory.

The safest rule is simple: don’t change a status just to make it look right. Change it only when a real event justifies it. An order that’s paid but not yet shipped normally remains «Processing.».

What do WooCommerce order statuses mean?

WooCommerce provides a basic cycle. However, payment method, the products sold, and active extensions can alter the flow. The official documentation on order statuses outlines the intended roles and transitions.

Draft: a temporary checkout order

The status Draft can appear with block-based checkout. It represents a temporary order created during payment submission. It’s not a confirmed sale, so there’s nothing to prepare at this stage.

After submission, an order that isn’t yet paid instead moves to «Pending payment.» Don’t confuse a draft with an unpaid or abandoned order.

Pending payment: the sale isn’t confirmed

The status Pending payment means WooCommerce has received the order without confirming payment. The customer may need to follow a payment link, retry a declined transaction, or complete an action with the payment provider.

Don’t prepare an order based on this alone. Check the order notes and the gateway interface. If the customer says they’ve paid, first verify the initial attempt before creating a new order.

Processing: payment received, work remains

The status Processing usually indicates payment has been received and the order must be fulfilled. For a physical product, it’s the cue to prepare the parcel, print the label, or hand it to the carrier.

WooCommerce generally does not automatically move a physical order from «Processing» to «Completed.» After shipping or actual fulfillment, you often need to make that change manually. Conversely, an order consisting only of virtual and downloadable products may complete automatically.

Completed: your obligation has been fulfilled

The status Completed indicates you have fulfilled your part of the sale. For a physical item, it often corresponds to a shipped order. For a service, it may correspond to a delivered service per your procedure.

This status doesn’t necessarily mean the customer has received their parcel. WooCommerce doesn’t natively add a distinct «Shipped» status. If that step matters in your operation, use a tracking number, a customer note, or a clearly defined custom status.

On hold: payment must be verified

The status On hold requires verification before processing. It often appears with a bank transfer, cheque, or other offline payment. Mark the order «Processing» or «Completed» only after you’ve confirmed receipt of funds.

A gateway can also keep an order in this state when it authorizes an amount without capturing it. The WooCommerce order troubleshooting tips then recommend reviewing the notes, payment method, and capture settings.

Failed, Cancelled, and Refunded: three distinct cases

These statuses may look similar in the dashboard, but they describe different situations:

  • Failed : the payment was declined or did not go through.
  • Cancelled : the customer or a team member cancelled the sale. WooCommerce can also cancel unpaid orders after the stock reservation timeout.
  • Refunded : an admin or manager refunded the entire order.

Manually marking an order «Refunded» doesn’t guarantee the money has been returned to the customer. A manual refund can change the status without sending the funds. Always confirm the transaction in the payment gateway or with your financial institution.

What path should you follow after an order?

For a physical product paid immediately by card, the common path is «On hold», then «Processing», then «Completed.» The gateway often makes the transition after payment confirmation. You then decide when the order is actually fulfilled.

For a bank transfer, the path looks more like: «On hold», verify funds, «Processing», then «Completed» after shipment. Document this process so everyone follows the same cues.

The order cycle should also match your inventory. Before changing multiple orders, make sure to manage WooCommerce stock without selling unavailable products. Without this check, a status change can skew your view of available quantities.

When should you change a status manually?

A manual change is useful when it records an action WooCommerce can’t detect on its own. This is often the case after confirming a transfer, shipping a parcel, or delivering a service.

Generally appropriate changes

  • You received and verified an offline payment: switch to «Processing» or, if nothing remains to be done, to «Completed.» .
  • You’ve shipped all items: move the physical order from «Processing» to «Completed.».
  • You cancel a sale before shipping: use «Cancelled,» then check the payment status.
  • You refund the full amount: use the refund tool, then confirm the transaction completed.

Changes to avoid without verification

Do not use «Processing» as proof that a transfer was received. Likewise, don’t mark an order «Completed» just because a label was created. Wait for the step that actually represents fulfillment in your business.

Also avoid turning a failed order into a paid order without reliable confirmation. Notes can contain a transaction reference, a decline, an authorization, or an update from the payment provider.

Finally, pay attention to notices sent to the customer. The WooCommerce transactional emails documentation states that multiple statuses are tied to notifications. Check your email templates before fixing a large number of orders.

A cautious method before making any corrections

Follow a short sequence before changing an order. This will reduce payment, inventory, and communication errors.

  1. Open the order and note the payment method, transaction reference, and notes.
  2. Confirm the payment in the gateway or bank account, when necessary.
  3. Check the products, quantities, and address before shipping.
  4. Perform the actual action: prepare, ship, cancel, or refund.
  5. Choose the status that describes that action and add an internal note if needed.

Logistics settings should support this routine. Your WooCommerce shipping zones, for example, should match the regions you actually serve.

If you need to correct many orders or intervene after an incident, work first on a reliable copy. This method will testing a WordPress backup restore help you prepare a controlled environment.

Should you create custom statuses?

A status like «To prepare,» «Shipped,» or «In production» can make a complex process clearer. However, each status adds transitions, possible emails, and rules to maintain. So start with native statuses if your cycle remains simple.

Add a custom status only if it describes a durable step, is understood by the whole team, and is useful for tracking. Decide who changes it, when, and what message the customer receives. WooCommerce order statuses will then remain a reliable tracking tool rather than a set of labels.