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


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


The add-on Custom Order Statuses is not compatible with X-Cart versions before X-Cart 5.2.7.


Viewing Order Statuses

With the add-on Custom Order Statuses installed and enabled, the complete list of order statuses used by your X-Cart store can be found ion the Order statuses page of your store 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 X-Cart store from the very start and work out of the box. They cannot be removed but, if necessary, can be renamed.

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

Such statuses can be deleted as well as renamed.

The order of statuses in the list determines the order in which the statuses 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 your own statuses. It is possible to create both payment and fulfillment order statuses.


Custom order statuses do not currently have the ability to 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. In your X-Cart store’s Admin area, go to the Order statuses section (Orders > Order statuses).

541-order-statuses-page.png

2. Make sure you are viewing the correct page tab. Payment statuses are added on the tab that 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:

541-order-statuses-add-status.png

A new blank field is added on a new line at the top of the order status list.

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.

Renaming Order Statuses

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

To rename an order status:

  1. In your X-Cart store’s Admin area, go to the Order statuses section (Orders > Order statuses).

  2. Make sure you view the correct page tab (Payment statuses can be found on the tab that opens by default. To access fulfillment statuses, 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).

  3. In the list of order statuses, locate the status that needs to be renamed.

  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. The new status name will be saved.

Deleting Order Statuses

It is possible to delete custom order statuses.


System order statuses cannot be deleted. 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. In your X-Cart store’s Admin area, go to the Order statuses section (Orders > Order statuses).

  2. Make sure you view the correct page tab (Payment statuses can be found on the tab that opens by default. To access fulfillment statuses, 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).

  3. In the list of order statuses, locate the status that needs to be deleted.

  4. Click the Trash icon opposite its name. The status will be marked for deletion.

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

Did this answer your question?