This article applies to the specific versions of software: X-Cart 5.2.7 and later.


In X-Cart v5.2.7 and later, you can manage order statuses using the Custom Order Statuses add-on.


The Custom Order Statuses add-on is compatible with X-Cart v5.2.7 and higher.


Viewing Order Statuses

With the Custom Order Statuses add-on installed and enabled, you can find the complete list of order statuses used in the store on the Order Statuses page of the Admin area (Orders > Order Statuses):

541-order-statuses-page.png

In fact, there are two lists since payment statuses and fulfillment statuses are listed separately. You can switch between the lists using the respective tabs:

541-order-statuses-payment-filfilment.png

For each order status on the list, the following information is provided:

  • Name: An order status name.

  • Orders: The number of orders currently in this status. The number is a link allowing you to access all the orders in this status as a list.

Order statuses with the Question icon displayed opposite their names in the column at the far right are the so-called system order statuses.

541-order-statuses-question-mark-icons.png

These statuses are present in your online store and work out of the box from the very start. You cannot remove them but, if necessary, rename them.

Hovering the cursor over a ? icon for a specific system status allows you to see the letter code by which this order status is referred to in the software code:

541-order-statuses-code-tooltip.png

Most people will have no use for this information, but we included it for X-Cart developers, who will look into the code to see how the order statuses work.


Order statuses with Trash icons displayed opposite their names instead of the Question icons - if any such statuses are present in your store - are custom order statuses.

541-order-statuses-custom-delete.png

You can delete such statuses as well as rename them.

The order of statuses in the list determines the order in which they appear in the drop-down selectors that the store administrator uses to assign payment and fulfillment statuses to an order.

You can rearrange this order by dragging and dropping specific statuses in the list to your required positions.

Use the four-headed arrows in the column at the far left.

541-order-statuses-reorder.png

Adding Custom Order Statuses

If X-Cart's system order statuses do not meet your business's needs, you can create custom statuses - both payment and fulfillment ones.


Custom order statuses cannot change the inventory levels of products in the order. Still, we are hoping to implement this feature in the nearest future.


To add a new order status:

  1. Go to the Order Statuses section in your store's Admin area (Orders > Order Statuses).

    541-order-statuses-page.png

  2. Make sure you are viewing the correct page tab. The Payment Statuses maintenance page opens by default.
    To add a fulfillment status, you will need to switch to the Fulfillment Statuses tab (In X-Cart versions before 5.3.3.0, this tab is titled Shipping Statuses).

    541-order-statuses-payment-filfilment.png

  3. Click the Add status button. You will see a new blank field added on a new line at the top of the order status list.

    541-order-statuses-add-status.png

  4. Use the blank field to enter the order status name you require.

  5. Click the Save changes button at the bottom of the list.

For example, you can use custom order statuses to arrange the "Click & Collect" notifications for customers who pay orders online and then pick up their purchases in a local office. For this purpose, create a custom fulfillment status. When you assign it to an order, your store will send a customer a regular "Order Changed" notification. Edit the default notification text as described here to make it more client-oriented and use the custom fulfillment status to inform customers that the orders are ready for collection.

Renaming Order Statuses

It is possible to rename existing order statuses, both system, and custom ones.

To rename an order status:

  1. Go to the Order Statuses section in your store's Admin area (Orders > Order Statuses).

  2. Select the tab you require - Payment Statuses or Fulfillment Statuses.

  3. In the list of order statuses, locate the status you want to edit.

  4. Click on the status name. The status name field becomes editable.

  5. Change the name of the status as you require.

  6. Click the Save changes button at the bottom of the list.

Deleting Order Statuses

It is possible to delete custom order statuses.


You cannot delete system order statuses. If you are not happy with the name of a system order status, you may want to consider renaming it.


To delete an order status:

  1. Go to the Order Statuses section in your store's Admin area (Orders > Order Statuses).

  2. Select the tab you require - Payment Statuses or Fulfillment Statuses.

  3. In the list of order statuses, locate the status you want to delete.

  4. Click the Trash icon opposite its name. It will mark the status for deletion.

  5. Click the Save changes button at the bottom. The status will be deleted.

Related pages:

Did this answer your question?