Place order tracking information onto customer note emails

Places the ShipStation order tracking information from ShipStation onto Customer Note emails. Supports USPS, UPS, and FedEx.

add_action( 'woocommerce_email_header', function( $email_heading, $email ) {

	// Limit To Specific Email
		empty( $email->id )
		|| ! in_array( $email->id, [ 'customer_note' ] )
	) {

	// Get Order
	$order = $email->object;
	if( ! $order ) {

	// Add Links
	add_filter( 'gettext', function( $text ) use( $order ) {

		// Limit To Specific Copy
		if( $text != 'As a reminder, here are your order details:' ) {
			return $text;

		// Get ShipStation Status
		global $wpdb;
		$sql = "
			SELECT comment_content
			FROM {$wpdb->comments}
			WHERE comment_post_ID = %d
			AND comment_content LIKE '%% shipped via %%'
			ORDER BY comment_ID DESC
			LIMIT 1
		$order_note = $wpdb->get_var(
			$wpdb->prepare( $sql, $order->get_id() )

		// Handle No Results
		if( ! $order_note ) {
			return $text;

		// Get Tracking Number From String
		$words = preg_replace( "/[^A-Za-z0-9 ]/", '', $order_note );
		$words = explode( ' ', $words );
		$last_index = sizeof( $words ) - 1;
		$tracking_num = $words[$last_index];

		// Detect USPS
		if( stristr( $order_note, 'USPS' ) ) {
			$order_note = str_replace( 'USPS', '<strong>USPS</strong>', $order_note );
			$tracking_link = '';

		// Detect UPS
		else if( stristr( $order_note, 'UPS' ) ) {
			$order_note = str_replace( 'UPS', '<strong>UPS</strong>', $order_note );
			$tracking_link = '';

		// Detect FedEx
		else if( stristr( $order_note, 'FedEx' ) ) {
			$order_note = str_replace( 'FedEx', '<strong>FedEx</strong>', $order_note );
			$tracking_link = '';

		// Get Tracking Link
		if( empty( $tracking_link ) ) {
			return $text;
		$tracking_link = sprintf(
			'<a target="_blank" href="%s=%s">%s</a>',

		// Output Link
				<p><strong>Track your package: %s</strong></p>

		// Return Text
		return $text;

	} );
}, 10, 2 );

PHP Code Snippets

  1. Log into a staging, development, or locally hosted clone of your site.
  2. Install and activate the Code Snippets plugin.
  3. Navigate to WP Admin > Snippets > Add New.
  4. Copy and paste the code from the Description tab above.
  5. Check to ensure formatting came over properly and no syntax errors show up in the editor.
  6. Customize the code as desired.
  7. Add a meaningful title and description.
  8. Select whether to run on front-end or back-end (or both). Some snippets require both.
  9. Click the “Save and Activate” button.
  10. Test your site to ensure it works as expected.
  11. Disable if any problems, or recover as necessary.
  12. Repeat steps two onward on your live environment.

HTML Reusable Blocks

Blocks may be imported into the Code Editor view of the WordPress Block Editor (three dots in the upper-right, select code editor). This is best used as a Reusable Block, which you can dynamically add into any page or post. In order to import as a Reusable Block navigate to your site with the following URI: /wp-admin/edit.php?post_type=wp_block or see my code snippet Add reusable blocks link to the Appearance menu.

  1. Describe the issue and what you’ve observed.
  2. Describe your expected outcome(s).
  3. List steps to reproduce the issue.
  4. Optionally provide screen-shot or video URLs.

We code all of our code snippets directly. Our clients provide most of the ideas and demand for the functionality provided by our code snippets.

There are several sources one can find on Google for code that has inspired or contributed to this open-source library. Here’s some main ones:

All code snippets are licensed GPLv2 (or later) matching WordPress licensing.

Disclaimer of warranty:

Except when otherwise stated in writing the copyright holders and/or other parties provide the program as-is without warranty of any kind, either expressed or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose.