How To Change Order Status In Woocommerce Programmatically

WooCommerce is a popular e-commerce platform that allows businesses to sell their products online. One of the key features of WooCommerce is the ability to manage orders and track their status. However, sometimes it may be necessary to change the order status programmatically, for example, if an order has been cancelled or refunded.

Step 1: Identify the Order ID

The first step in changing the order status programmatically is to identify the order ID. This can be done by accessing the WooCommerce database and looking for the order_id column in the wp_woocommerce_orders table.

Example Code

$order_id = get_post_meta( $product_id, 'order_id', true );
if ( ! empty( $order_id ) ) {
    // Do something with the order ID
} else {
    // The order ID is not present in the database

Step 2: Determine the New Status

Once you have identified the order ID, the next step is to determine the new status that you want to assign to the order. WooCommerce has a number of predefined statuses that can be used, such as “processing”, “completed”, or “cancelled”. Alternatively, you can create your own custom statuses using the WooCommerce API.

Example Code

$new_status = 'completed';
// Or use a custom status: $new_status = 'custom-status';

Step 3: Update the Order Status

Finally, you can update the order status by using the WooCommerce API. This can be done using the update_order_status() function, which takes two arguments: the order ID and the new status.

Example Code

$result = update_order_status( $order_id, $new_status );
if ( is_wp_error( $result ) ) {
    // An error occurred while updating the order status
} else {
    // The order status has been successfully updated


In conclusion, changing the order status programmatically in WooCommerce is a simple process that involves identifying the order ID, determining the new status, and updating the order status using the WooCommerce API. By following these steps, you can easily manage your orders and ensure that they are accurately tracked and reported.