Adding Custom Content to Specific Order Emails in WooCommerce

WooCommerce is a popular eCommerce platform that offers extensive flexibility in customizing emails. Whether you want to add content to the customer processing order email or any other email type, this guide will help you implement the necessary changes using a simple PHP snippet. This article is designed to be SEO-friendly and optimized for Google.

How to Add Custom Content to a Specific Order Email in WooCommerce

This tutorial explains how to add custom content to a specific order email in WooCommerce. If you are working with WooCommerce version 3.5.1, the following steps will be useful for you.

Step 1: Identify the Email ID

First, you need to identify the email ID that triggers the email you want to modify. Here are some commonly used email IDs in WooCommerce:

customer_processing_order new_order customer_completed_order customer_invoice customer_new_account customer_on_hold_order customer_refunded_order customer_cancelled_order failed_order customer_note

Step 2: Add the PHP Snippet

To add custom content to the selected order email, follow these steps:

Add the following PHP code to your child theme’s file:

add_action( 'woocommerce_email_before_order_table', 'bbloomer_add_content_specific_email', 20, 4 );
function bbloomer_add_content_specific_email( $order, $sent_to_admin, $plain_text, $email ) {
    if ( $email->id  'customer_processing_order' ) {
        echo '
This is a custom section for the processing order email.
';
    }
}

Step 3: Customize the Content

Within the function, you can customize the content and styling as needed. For example, if you want to add this section to the customer_processing_order email, you can modify the condition to:

if ( $email->id  'customer_processing_order' ) {
    echo '
Custom Content Here
';
}

The h2 tag will have the class 'custom-header' applied to it, allowing you to style it directly in your CSS. You can also use other HTML elements like p, div, or any other relevant tag to structure the content.

Step 4: Test and Deploy

Test your modifications across different scenarios to ensure that the custom content appears in the desired email and that it does not interfere with other elements. After thorough testing, deploy the changes to your production site with confidence.

Advanced Customizations

You can further customize the content by adding more conditions or using additional WooCommerce functions. For example, you can retrieve order details and use them in the custom content:

add_action( 'woocommerce_email_before_order_table', 'bbloomer_add_content_specific_email', 20, 4 );
function bbloomer_add_content_specific_email( $order, $sent_to_admin, $plain_text, $email ) {
    if ( $email->id  'customer_processing_order' ) {
        echo '
Order ID: ' . $order-get_id() . '
';
        echo '
Custom content based on order details: ' . $order-get_total() . '
';
    }
}

Other Order Emails You Can Target

The same snippet can be used to target different emails by changing the email ID. Here are some additional examples:

cancelled_order customer_completed_order customer_invoice customer_new_account customer_note customer_on_hold_order customer_refunded_order customer_cancelled_order failed_order new_order

Conclusion

By adding custom content to specific order emails in WooCommerce, you can provide valuable information to your customers, enhance their experience, and streamline your business operations. With the right snippets and techniques, you can customize your WooCommerce emails to fit your unique needs.

Further Reading

WooCommerce Actions and Filters WooCommerce Tips and Tricks Scripts WordPress add_action Function