View Product Page

Import custom statuses

Do you have custom status set up in a .CSV file and need to import them? No problem, it’s easy and will take just one click.

Go to the plugin settings panel YITH > Custom Order Status > Settings and click on the Import custom statuses button.

Import custom statuses

This will automatically import all statuses created with third-party plugins into your custom statuses and will be then visible in the main plugin panel YITH > Custom Order Status > Custom statuses, so you can start customizing them here.

Please, note, before applying the import, you must make sure that the plugin with which you have previously created the statutes is installed and activated, otherwise, this import will produce no effect.

Configure a new status

To start creating new order statuses, go to YITH > Custom Order Status > Order Statuses tab and click on Add Order Status.

Add order status
Add the name and set the options that you can find in the Settings tab of the page.

Order status settings

Below you’ll find the complete list of the options:

  • Status Type: the type of the new status. You can create a new status by choosing Custom Status, or overwrite a WooCommerce status by selecting one of the other entries of the list.
  • Slug: enter a unique slug that defines the status.
  • Color: the color for the status.
  • Icon: the icon for the status. Choose between the default one (also available in the free version of the plugin), or the complete list of Font Awesome icons.
  • Graphic Style: choose between icon or textual label. For the latter, the label will be also the name of the status.


Custom order status icons

Textual label:

Custom order status label

If you are not able to see the “Next Actions” column in the orders oversight, click on “Screen options” and enable the actions option.

Enable next actions

  • Next Actions: actions that you can apply to the order when it has the status you are setting. Choose among the default WooCommerce actions and those you have created.
    Below is an example in which “Completed” and “Delivery” are selected as next actions of the status.

Next actions example

  • User can pay: enable this option if you want that users can pay the order when this status is set. Leave it disabled if no payment is allowed with this status.
  • User can cancel: enable this option if you want your users to be free to cancel the order when this has the status you are configuring.

My Account page

  • Order is paid: WooCommerce statuses include an option to consider them paid or not. Processing and Completed are considered paid, whereas the others aren’t. Enable this option if you want to consider your custom status as paid as well.
    Protip: we suggest enabling this option if your custom status follows a Processing or Completed status.
  • Allow downloads: this option allows users to download the file assigned to the order when this has the status you have created.
  • Display in Reports: activate this option to include all the orders with the status you are configuring in the WooCommerce report (“WooCommerce -> Reports”)
  • Restore stock: enable this option if you want to restore the order stock items when this custom status is applied.
  • Show always in Actions: enable this option to always show this custom status in the Actions column on the Orders page.

You will be able to see all options you did or did not apply to the created order status in the custom order status list table.

Enabled/disabled options

WooCommerce Analytics

The colors of the custom statuses you have created will show in WooCommerce > Analytics > Orders as in the example below.

Analytics - Orders

Enable shop manager

If you want the shop manager to be able to manage custom order statuses as well, enable the option in the plugin settings.

Enable shop managers

Email configuration

Email settings

The Email settings tab will be available only if you create a custom status. In this case, you’ll have to configure the email that will be generated when the order will get the status you are configuring.
Below are all the options you can set:

    • Send email to: the recipient of the email. You can select:
      • none
      • administrator
      • customer
      • custom email address
      • Vendor* (*only if  YITH WooCommerce Multi Vendor is activated).
    • “From” Name: the sender name that will be shown to the recipients.
    • “From” Email Address: the email address of the sender that will be shown to the recipients.
    • Email Subject: the subject of the email.
    • Email Heading: the text shown ahead of the body of the email.
    • Custom Message: in this field add the text of the email taking advantage of the placeholders the plugin offers to dynamically recover some of the order information that you want to show in the email content. These are the available placeholder:
      • {customer_first_name}: the user name.
      • {customer_last_name}: the user surname.
      • {order_date}: the date on which the order has been made.
      • {order_number}: the order number.
      • {order_value}: the total amount of the order.
      • {billing_address}: the billing address of the user.
      • {shipping_address}: the shipping address of the user.
      • {billing_country}: the billing country of the user.
    • Include Order Information: this option lets you add the list of the products of the order, the billing address and the shipping address in the email.


YITH WooCommerce Multi Vendor

With YITH Multi Vendor you can turn your e-commerce store into a marketplace (a multi-vendor platform) like Amazon or Etsy. Turn your e-commerce store into a marketplace (a multi-vendor platform) and earn commissions on orders generated by your vendors.

You will only have to install and activate both plugins, in order to make them work together.

If you want your vendors to manage their own suborders – they will be able to use the custom statuses too – you will have to enable them to Manage orders from the → Vendors permissions.

Custom statuses created by general admins can now be used also by vendors on their own suborders.

Integration with YITH Multi Vendor

Additionally, as for every custom order you can also set a custom email and its recipients, you can add the vendor as a recipient as well.

Example: you want to create a custom Shipped status and create an email notification that informs both the customer and the vendor that the product has been shipped. Select the status and go to Email Settings: here you can add both the customer and the vendor role in the recipient. The email will automatically be sent to the customer and to the vendor to whom the sold product belongs.

Integration with YITH Multi Vendor

For more details about YITH Multi Vendor setup, please, refer to the plugin documentation here.