Documentation Commerce Stores and Purchase Experience

Order status

Last update: March 22, 2024

Topics:
Orders

CREATED FOR:

Beginner
Intermediate
Admin
User

All orders have an order status that is associated with a stage in the order processing workflow.
The difference between order states and order statuses, is that order states are used programmatically. They are not
visible to customers or Admin users. They determine the flow of an order, and which operations are possible for an
order in a certain state.
Order statuses are used to communicate the status of an order to customers and admin users.
You can create additional order statuses to align with your operational needs. Order statuses are convenient to display
progress outside of Adobe Commerce, for example order picking and delivery progress. They have no impact on the order
processing workflow.
Each order status is associated with an order state. Your store has a set of predefined order status and
order state settings.

Order states and statuses

The status of each order is shown in the Status column of the Orders grid.

Order Status

TIP

A partially refunded order remains in Processing status until all ordered items (including refunded items) are shipped. The order status does not change to Complete until every item in the order has been shipped.

Order state workflow

Predefined status

Order Status	Status Code
Received	`received`	This status is the initial status for orders that are placed when asynchronous order placement is enabled.
Suspected Fraud	`fraud`	Sometimes orders paid via PayPal or another payment gateway are marked as Suspected Fraud. This status means that the order does not have an invoice issued, and the confirmation email is also not sent.
Processing	`processing`	When the status of new orders is set to ‘Processing’, the Automatically Invoice All Items option becomes available in the configuration. Invoices are not created automatically for orders placed by using Gift Card, Store Credit, Reward Points, or other offline payment methods.
Pending Payment	`pending_payment`	This status is used if the order is created and PayPal or similar payment method is used. It means that the customer was directed to the payment gateway website, but no return information has been received yet. This status changes when customer pays.
Payment Review	`payment_review`	This status appears when PayPal payment review is turned on.
Pending	`pending`	This status indicates that no invoice and shipments have been submitted.
On Hold	`holded`	This status can only be assigned manually. You can put any order on hold.
Complete	`complete`	This status means that the order is created, paid, and shipped to customer.
Closed	`closed`	This status indicates that an order was assigned a credit memo and the customer has received a refund.
Canceled	`canceled`	This status is assigned manually in the Admin or, for some payment gateways, when the customer does not pay within the specified time.
Rejected	`rejected`	This status means that an order was rejected during asynchronous order processing. This happens when en error occurs during asynchronous order placement.
PayPal Canceled Reversal	`paypay_canceled_reversal`	This status means that PayPal canceled the reversal.
Pending PayPal	`pending_paypal`	This status means that the order was received by PayPal, but payment has not yet been processed.
PayPal Reversed	`paypal_reversed`	This status means that PayPal reversed the transaction.

Custom order status

In addition to the preset order status settings, you can create your own custom order status settings, assign them to order states, and set default order statuses for order states. The order state indicates the position of the order within the order processing workflow and the order status assigns a meaningful translatable label to the position of the order. For example, you might need a custom order status such as packaging", backordered, or a status that is specific to your needs. You can create a descriptive name for the custom status and assign it to the associated order state in the workflow.

NOTE

Only default custom order status values are used in the order workflow. Custom status values that are not set as default can be used only in the comments section of the order.

Order Status settings

Create a custom order status

On the Admin sidebar, go to Stores > Settings > Order Status.
In the upper-right corner, click Create New Status.
Update the Order Status Information section:
- Enter a Status Code for internal reference. The first character must be a letter (a-z), and the rest can be any combination of letters and numbers (0-9). Use the underscore character instead of a space.
- For Status Label, enter a label that identifies the status setting in both the Admin and storefront.
In the Store View Specific Labels section, enter any labels that are needed for different store views.
Click Save Status.

Assign an order status to a state

On the Order Status page, click Assign Status to State.
Update the Assignment Information section, do the following:
- Choose the Order Status that you want to assign. They are listed by status label.
- Set Order State to the place in the workflow where the order status belongs.
  
  NOTE
  Order State list includes the default assigned order statuses. For example, the Pending default order status is displayed instead of the New order state value.
- To make this status the default for the order state, select the Use Order Status as Default checkbox.
  
  NOTE
  Only the default order statuses are used in the order workflow. Non-default statuses can only be set in the Order Comments section in the Admin.
- To make this status visible from the storefront, select the Visible On Storefront checkbox.
Click Save Status Assignment.

Edit an existing order status

In the Order Status grid, open the status record in edit mode.
Update the status settings as needed.
Click Save Status.

Remove an order status from an assigned state

NOTE

A status setting cannot be unassigned from a state if the status is in use.

In the Order Status grid, find the order status record to be unassigned.
In the Action column on the far right of the row, click the Unassign link.

A message appears at the top of the workspace that the order status has been unassigned. Although the order status label still appears in the list, it is no longer assigned to a state. Order status settings cannot be deleted.

NOTE

If the default order status is unassigned from the order state, another order status is set automatically as a default for this order state.

Notification

Customers can track the status of their orders by RSS feed if the Order RSS feed is enabled in the configuration. When enabled, a link to the RSS feed appears on each order.

Enable order status notification

On the Admin sidebar, go to Stores > Settings > Configuration.
In the left panel, expand Catalog and choose RSS Feeds underneath.
Expand the Order section.
Set Customer Order Status Notification to Enable.
When complete, click Save Config.

Configure new order email notifications

On the Admin sidebar, go to Stores > Settings > Configuration.
In the left panel, expand Sales and choose Sales Emails underneath.
Expand the Order section.
Set New Order Confirmation Email Sender to one of the following:
- General Contact
- Sales Representative
- Customer Support
- Custom Email 1
- Custom Email 2
Choose the templates that you want to use for each customer type:
- New Order Confirmation Template - Choose a template to use for customers with a registered store account.
- New Order Confirmation Template for Guest - Choose a template to use for guest customers without a registered store account.
To notify another person (such as a business manager) about the new order, enter the email address to Send Order Email Copy To.

You can add multiple email addresses if more than one recipient is required.
Set the Send Order Email Copy Method to one of the following:
- Bcc - Only one email about the new order is sent to both customer and the additional recipient, but the customer does not see that the email they received was also sent to the additional recipient.
- Separate Email - Two separate emails are sent—one to the recipient and one to the customer.
When complete, click Save Config.

recommendation-more-help