This website uses cookies

Our website, platform and/or any sub domains use cookies to understand how you use our services, and to improve both your experience and our marketing relevance.

How To Add Custom Order Emails in WooCommerce

Updated on March 17, 2022

7 Min Read

Suppose after several days of hard work, you successfully setup your store on a specialized WooCommerce web hosting platform

The product page is now connected to a flawlessly working database and the checkout process has no problems at all. Every single element including the product pages, gallery, and feedback reflect the colors and style of your brand.

Then you decide to test your product ordering process and suddenly discover that order email is rather bland or too generic from the users’ point of view. Now you must be wondering what all your hard work of customizing your WooCommerce store was all for nothing.

WooCommerce includes several order statuses that may not match the flows of your store but still you can mark orders with custom status such as Payment Pending, Processing, On Hold, Failed, etc.

Many WooCommerce store owners and administrators have this common query: How can I modify the default WooCommerce request messages to have my brand’s look and feel and how can I add additional content to help clients with their order as well as how to create custom WooCommerce order status.

While making impressive HTML emails is truly an achievement in itself, WooCommerce offers several options so that even amateurs could create some amazing emails.

Blazing Fast WooCommerce Speeds With Cloudways

Struggling to deploy apps to live servers?
Get our eBook to learn the simplified app deployment process for your projects.

Thank You

Your Ebook is on it’s Way to Your Inbox.

Customer Emails

“Vanilla” offers WooCommerce email notifications that are sent to customers in response to their interactions with the store. The following are the most important emails for the customers of your WooCommerce store.

  • New Order:  New order emails are sent when a new order is received.
  • Cancelled Order: Cancelled order emails are sent when order(s) has been marked as cancelled.  
  • Failed Order: Failed order emails are sent when an under processing or on-hold order is marked as Fail.
  • Order On hold: This is an order notification sent to customers. It contains order details after an order is placed on-hold.
  • Processing Order: This is an order notification sent to customers. It contains order details after payment.
  • Completed Order:  Order complete emails are sent to customers when their orders are marked completed. These emails usually indicate that the orders have been shipped.
  • Refunded Order: Order refunded emails are sent to customers when their orders are marked refunded.
  • Customer Invoice: Customer invoice emails contain order information and payment links.
  • Customer Note: Customer note emails are sent when you add a note to order.
  • Reset Password: Customer “reset password” emails are sent when customers reset their passwords.
  • New Account: Customer “new account” emails are sent to the customer when a customer signs up via checkout or account sign up page.

In addition to these standard email types, you can add customized emails as well.

Managed WooCommerce Hosting Starting from $10/month.

Create, manage, and customize your WooCommerce store with complete freedom.

WooCommerce Global Email Options

The standard WooCommerce email looks like this:

The WooCommerce admin allows some basic customization of this default email layout. These options could be accessed after logging in to the WordPress Admin and going to WooCommerce > Settings > Emails > Email  Sender Options. These options include:

  • Set the From name/address (visible to the customer)
  • WooCommerce email header image size
  • Change the email footer text
  • Choose different base, background, and body text colors

WooCommerce Email Option

WooCommerce Email Option

Remember that these choices apply to all emails. In just a matter of minutes, you can create a highly customized email by altering WooCommerce email header image size, custom footer text, and another base color.

Email template

You might have noticed that the WooCommerce identified that a bright base color was used. To compensate, it used a suitable shade for the title. Unfortunately, this logic was not applied to the footer’s content. This mishap can easily be fixed manually!  

WooCommerce Email Specific Options

Every email type has its own set of customization options. These options can be accessed through WooCommerce > Settings > Emails > Processing order (This example path focuses on Processing Order Emails. You can alter several aspects of the email, including:  

  • Enable or Disable whether the email is even sent at all
  • The email’s subject
  • Email heading (The default is “Thank you for your order”)
  • Whether the email is sent as HTML or plain text (The default option is HTML)

Processing Ordder

Here, I have set the custom email heading as ‘Thank You For Your Order.’

Processing Ordder

Overriding Custom Email WooCommerce Template

A more effective and efficient approach is to modify the default email layouts. WooCommerce offers a helpful template system that allows you to customize parts of your store or emails by replicating the format file(s) into the theme. Every email type has a template file for its content (For example, woocommerce/templates/emails/customer-process-order.php). In addition, there are shared templates that all email types can access and use. These could be found at  woocommerce/templates/emails/email-styles.php. In many cases, this is the template that developers override to change shared aspects of the emails. The process of dealing with the footer issue mentioned earlier is:

  1. First you make sure that the following directory exists in the WordPress installation: wp-content/themes/your-theme/woocommerce/emails.
  2. Next, copy the file found at wp-content/plugins/woocommerce/templates/emails/email-styles.php into the store’s theme at: your-theme/woocommerce/emails/.
  3. Finally, edit your-theme/woocommerce/emails/email-styles.php to change the footer text color to black (for brevity, only the relevant part of the template file code is shown):
$credit = "
color: #66bae3;


This generates a much more readable footer:


Conditional Customization with Actions/Filters

The final and most effective approach to customizing emails is to work with WooCommerce custom code. This obviously requires a high-level of expertise in PHP. The good news is that the process is straightforward because the original WooCommerce layouts are still in use. The process involves changing portions of the content.

Filter Functions

Actions Functions

Activation/Deactivation/Uninstall Functions

For this example, I will add some helpful payment instructions to the email, based on the checkout payment type used.

To start, add the following to the theme’s functions.php:

add_action( 'woocommerce_before_email_order', 'add_order_instruction_email', 10, 2 );
function add_order_instruction_email( $order, $sent_to_admin ) {
  if ( ! $sent_to_admin ) {
    if ( 'cod' == $order->payment_method ) {
      // cash on delivery method
      echo '<p><strong>Instructions:</strong> Full payment is due immediately upon delivery: <em>cash only, no exceptions</em>.</p>';
    } else {
      // other methods (ie credit card)
      echo '<p><strong>Instructions:</strong> Please look for "Madrigal Electromotive GmbH" on your next credit card statement.</p>';

If the customer opted for “Cash on Delivery” when checking out, the customer will receive the email with helpful order instructions:

WooCommerce Checkout setting

Plugin/Payment Gateway Options

Several plugins and payment gateways actually allow you to customize parts of the order emails. For instance, the built-in bank/wire transfer payment method allows you to configure instructions and insert wire transfer information. This could be done easily through  WooCommerce > Settings > Checkout > BACS.

WooCommerce Checkout setting

Although it’s uncommon, it is good to know that these options are available. This information could also help you in opting for a particular plugin for the store.

WooCommerce Emails add_actions Hook

When working with WooCommerce emails, add_actions hook often comes handy. When working with this hook, you will need to use a global variable, email that will contain email subject. here is the code snippet:

add_action( 'woocommerce_email_header', 'woocommerce_emails_before_header', 1,3 );
function woocommerce_emails_before_header( $email_heading, $email ){
    $GLOBALS['email'] = $email;

The above hook can be placed in functions.php ( located in your theme folder) or at the start of the WooCommerce email template. the global variable $email calls the main WooCommerce email object, while $order contains an instance of the global WooCommerce order object

global $email; 
$order = $email->object;

WooCommerce Custom Email Per Product

Following code send custom order emails template for a different product

for example for the product ID 87 you want to display the header title WooCommerce email notification OR how to test WooCommerce emails:

function woocommerce_custom_email_per_product_depending_on_product_id( $email_heading, $order ) {
    global $woocommerce;
    $items = $order->get_items();
    foreach ( $items as $item ) {
        $product_id = $item['product_id'];
        if ( $product_id == 87 ) {
            $email_heading = 'WooCommerce email notification OR how to test WooCommerce emails';
        return $email_heading;
add_filter( 'woocommerce_email_heading_customer_processing_order', 'woocommerce_custom_email_per_product_depending_on_product_id', 10, 5 );

Note:  Now that you know the entire process of Customizing WooCommerce order emails, you now have the choice of either retaining the function or creating a separate WooCommerce email plugin for Woocommerce email confirmation and notification.


Setting up a WooCommerce store is pretty easy but customizing the default email templates becomes tricky sometimes. In this tutorial, I discussed how you can send fully customized WooCommerce hosted store emails to accommodate all aspects of the store’s activities. I also highlighted the way in which the default email templates can be altered to insert store-specific and order-specific information in emails for providing the better user experience.

Leave a comment below if you wish to add to the discussion or ask a question!

Share your opinion in the comment section. COMMENT NOW

Share This Article

Customer Review at

“Great performance for the price, and plenty of control”

Sean P [SMB Owner]

Owais Alam

is the WordPress Community Manager at Cloudways - A Managed WooCommerce Hosting Platform and a seasoned PHP developer. He loves to develop all sorts of websites on WordPress and is in love with WooCommerce in particular. You can email him at [email protected]


Get Our Newsletter
Be the first to get the latest updates and tutorials.

Thankyou for Subscribing Us!


Webinar: How to Get 100% Scores on Core Web Vitals

Join Joe Williams & Aleksandar Savkovic on 29th of March, 2021.

Do you like what you read?

Get the Latest Updates

Share Your Feedback

Please insert Content

Thank you for your feedback!

Do you like what you read?

Get the Latest Updates

Share Your Feedback

Please insert Content

Thank you for your feedback!