WooCommerce: Translate / Rename Content @ Order Emails

WooCommerce order emails customization is possibly the most wanted feature for WooCommerce store owners and developers right now. It is very difficult to edit the default templates and it’s no surprise there are many email customizer plugins out there.

We’ve already seen how to add content to specific WooCommerce emails, how to add custom email CSS, how to display product images, and more, but today I’d like to teach you a quick workaround to edit the default email text strings such as the initial greeting (‘Hi Mary,‘) or other sentences (‘We have finished processing your order.‘, ‘The following note has been added to your order:‘, ‘Just to let you know — we’ve received your order, and it is now being processed:‘, etc.).

With “edit”, of course, I mean either change the text, or completely hide it. So, let’s see how it’s done. Enjoy!

With the snippet below, I was able to hide the Customer Processing Email greeting Hi %s,, and edit the default sentence from Just to let you know — we've received your order, and it is now being processed: to Your payment was successful and we are now getting ready for shipping. Expect another email from us with tracking details soon!

PHP Snippet: Edit / Translate / Hide Text Strings @ WooCommerce Order Emails

Note 1: in the snippet below you find 2 examples. The first one hides the string (in fact it replaces it with an empty string). The second one, on the other hand, replaces the original string with a custom one.

Note 2: inside the str_ireplace function you must enter the original string as the first parameter, exactly as defined by WooCommerce. Sometimes WooCommerce uses weird symbols such as ‘Hi %s,‘, which are actually placeholders. The only way to make this work is to enter exactly that string: ‘Hi %s,‘. You can find these strings inside the plugin files, so I recommend you use a good code editor such as NotePad++ or Visual Studio Code so that you can quickly search through the WooCommerce plugin code.

Note 3: you can add as many $translated = str_ireplace() calls as you wish, one for each edit you want to make.

/**
 * @snippet       Edit Strings @ WooCommerce Emails
 * @how-to        businessbloomer.com/woocommerce-customization
 * @author        Rodolfo Melogli, Business Bloomer
 * @compatible    WooCommerce 8
 * @community     Join https://businessbloomer.com/club/
 */

add_filter( 'gettext', 'bbloomer_translate_woocommerce_strings_emails', 9999, 3 );
 
function bbloomer_translate_woocommerce_strings_emails( $translated, $untranslated, $domain ) {
	if ( 'woocommerce' === $domain ) {   
		$translated = str_ireplace( 'Hi %s,', '', $untranslated ); // HIDE
		$translated = str_ireplace( 'Just to let you know — we\'ve received your order #%s, and it is now being processed:', 'Your payment was successful and we are now getting ready for shipping. Expect another email from us with tracking details soon!', $untranslated ); // EDIT
	}
	return $translated;
}

Where to add custom code?

You should place custom PHP in functions.php and custom CSS in style.css of your child theme: where to place WooCommerce customization?

This code still works, unless you report otherwise. To exclude conflicts, temporarily switch to the Storefront theme, disable all plugins except WooCommerce, and test the snippet again: WooCommerce troubleshooting 101

Related content

Rodolfo Melogli

Business Bloomer Founder

Author, WooCommerce expert and WordCamp speaker, Rodolfo has worked as an independent WooCommerce freelancer since 2011. His goal is to help entrepreneurs and developers overcome their WooCommerce nightmares. Rodolfo loves travelling, chasing tennis & soccer balls and, of course, wood fired oven pizza. Follow @rmelogli

6 thoughts on “WooCommerce: Translate / Rename Content @ Order Emails

  1. The ‘Hi %s,’ insn’t hide or replaced in the email, any solution?

    1. Please paste your code here and I’ll take a look

  2. Hi there! I am trying to use the snippet for translating a string in a specific email template, but unfortunately, it’s not working. Is there anything I need to change, if it’s a specific template? I am talking about the new account template. Thanks!

    1. Hello Vanya, which string are you trying to translate?

  3. That for sure is fast way to work arround but i still cant decide which method is the better approach in terms of multilang store performance. Duplicating the templates and changing the text inside and after that generating po mo files for each language. Or using this method and based on current language to load translation?

    1. Whichever works for you!

Questions? Feedback? Customization? Leave your comment now!
_____

If you are writing code, please wrap it like so: [php]code_here[/php]. Failure to complying with this, as well as going off topic or not using the English language will result in comment disapproval. You should expect a reply in about 2 weeks - this is a popular blog but I need to get paid work done first. Please consider joining the Business Bloomer Club to get quick WooCommerce support. Thank you!

Your email address will not be published. Required fields are marked *