Custom Order Status

In addition to the preset order status settings, you can create custom order status settings of your own, assign them to order states, and set a default order status for order states. 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.

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

To create a custom order status:

  1. On the Admin sidebar, click Stores.

  2. In the Settings section, choose Order Status.

  3. In the upper-right corner, click Create New Status.

    Create New Order Status

  4. 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.

    • Enter a Status Label to identify the status setting in both the Admin and storefront.

  5. In the Store View Specific Labels section, enter any labels that are needed for different store views.

  6. Click Save Status.

To assign an order status to a state:

  1. On the Order Status page, click Assign Status to State.

    Assign Status

  2. 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.

    • To make this status the default for the order state, select the Use Order Status as Default checkbox.

    • To make this status visible from the storefront, select the Visible On Storefront checkbox.

    Assign Status to State Assign Status to State

  3. Click Save Status Assignment.

To edit an existing order status:

  1. In the Order Status grid, open the status record in edit mode.

  2. Update the status settings as needed.

  3. Click Save Status.

To remove an order status from an assigned state:

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

  1. In the Order Status grid, find the order status record to be unassigned.

  2. 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.

Order Status and State

Order Status Order State  
Processing processing When the state of new orders is set to “Processing”, the Automatically Invoice All Items option becomes available in the configuration.
Suspected Fraud fraud  
Pending Payment pending_payment  
Payment Review payment_review  
Suspected Fraud fraud  
Pending pending  
On Hold holded  
Complete complete  
Closed closed  
Canceled canceled  
PayPal Canceled Reversal payment_canceled_reversal  
PayPal Reversed paypal_reversed  
Pending PayPal pending_paypal