Skip to main content
Effective order management is essential for any ecommerce business - it ensures timely processing, accurate fulfillment, and a smooth customer experience. In Spree, Order States help you track and manage each stage of an order, so you can quickly identify next steps or potential issues. To review order states, navigate to the Orders tab of the admin dashboard. Spree Commerce dashboard showing various order states You’ll see a list of all orders placed in your store, with two key columns:
  • Payment State - shows the current payment status
  • Shipment State - shows the current shipping status
Together, these determine the overall state of the order.

​
Payment States

The Payment State indicates the current status of payments associated with the order. An order can have multiple payments, but Spree will show the relevant state based on the most recent or net balance.
You cannot manually set the payment state. It updates automatically based on actions like capturing payments, issuing refunds, or adjusting the order total.

​
Shipment States

The Shipment State reflects the current status of all shipments tied to an order. Orders can have one or multiple shipments depending on stock locations or backorders.
Like payment state, shipment state is managed automatically based on order and fulfillment actions.

​
Using Order States Effectively

Understanding these states makes it easier to manage operations and know exactly what action to take. Here are some common scenarios:

​
Next Steps

Now that you’re familiar with how order states work, we recommend checking out related docs for deeper insights: