WooCommerce

Overview

WooCommerce is one of many eCommerce solutions that are available for WordPress. Groundhogg has an integration with WooCommerce.

The WooCommerce integration is available as part of our Pro plan, or you can buy the extension individually. Once WooCommerce, Groundhogg, and the WooCommerce extension for Groundhogg are installed and activated, you will have access to:

Triggers

Woocommerce Integration comes with these triggers.

New Order

This trigger executes when a new order is placed and can be defined with: 

• Any/All If the order contains these products 
• Any/All contains products in these categories
• Any/All contains products with these tags
• Order subtotal is (Equal to, less than, less than or equal to, greater than, greater than or equal to) the value of the order
• Processed via any of these payment gateways

Order Status Changed

This trigger executes when the status of the order changes from one status to another and can be defined with:  

• When the order status is changed from (Pending payment, Processing, On Hold, Completed, Cancelled, Refunded, Failed, Draft or other custom statuses)
• To any of these statuses(Pending payment, Processing, On Hold, Completed, Cancelled, Refunded, Failed, Draft or other custom statuses)
• Any/All If the order contains these products
• Any/All contains products in these categories
• Any/All contains products with these tags
• Order subtotal is (Equal to, less than, less than or equal to, greater than, greater than or equal to) the value of the order
• Processed via any of these payment gateways.

Cart Updated

This trigger executes when the cart is updated and can be defined: 

• Any/All If the cart contains these products
• Any/All contains products in these categories
• Any/All contains products with these tags
• The value of the cart is (Equal to, less than, less than or equal to, greater than, greater than or equal to) the value of the order.

Emptied Cart

This trigger executes when users remove all the products from their carts.

Cart Abandoned*

This trigger executes when the cart is abandoned and can be defined: 

• Any/All when the cart is abandoned and contains these products
• Any/All contains products in these categories
• Any/All contains products with these tags
• The value of the cart is (Equal to, less than, less than or equal to, greater than, greater than or equal to) the value of the order.

*Triggered from inactivity for 15 minutes. 

Filters*

Groundhogg’s WooCommerce Integrations provide filters to allow you to: 

Order Activity

The “Order Activity” filter allows you to filter contacts based on their order-related activities.

1. Enter a Value of an order (At least, At most, More than, Less than, Exactly)
2. Enter the number of Times ordered(At least, At most, More than, Less than, Exactly)
3. In what period of time (At any time, Today, This week, Last week, This month, Last Month, This year, In the last 24 hours, In the last 7 days, In the last 14 days, In the last 30 days, In the last 60 days, In the last 90 days, In the last 365 days, In the last X days, Before, After, Between)
4. Click the ✓ to apply the filter
5. Click the trash can to remove the filter

Purchased Product

The “Purchased Product” filter allows you to filter contacts based on whether they have purchased a specific product.

1. Select one or more products
2. In what period of time (At any time, Today, This week, Last week, This month, Last Month, This year, In the last 24 hours, In the last 7 days, In the last 14 days, In the last 30 days, In the last 60 days, In the last 90 days, In the last 365 days, In the last X days, Before, After, Between)
3. Click the ✓ to apply the filter
4. Click the trash can to remove the filter

Purchased Product in Category

The “Purchased Product in Category” filter allows you to filter contacts based on whether they have purchased a product from a specific category within a defined time frame.

1. Select one or more categories
2. In what period of time (At any time, Today, This week, Last week, This month, Last Month, This year, In the last 24 hours, In the last 7 days, In the last 14 days, In the last 30 days, In the last 60 days, In the last 90 days, In the last 365 days, In the last X days, Before, After, Between)
3. Click the ✓ to apply the filter
4. Click the trash can to remove the filter

Purchased Product with Tag

The “Purchased Product with Tag” filter allows you to filter contacts based on whether they have purchased a product associated with a specific tag.

1. Select one or more tags
2. In what period of time (At any time, Today, This week, Last week, This month, Last Month,This year, In the last 24 hours, In the last 7 days, In the last 14 days, In the last 30 days, In the last 60 days, In the last 90 days, In the last 365 days, In the last X days, Before, After, Between)
3. Click the ✓ to apply the filter
4. Click the trash can to remove the filter

Lifetime Customer Value

The “Lifetime Customer Value” filter allows you to filter contacts based on their total lifetime spending.

1. Select Customer Value is (Equals, Not equals, Less than, Less than or equal to, Greater than, Greater than or equal to )
2. Enter a value
3. Click the ✓ to apply the filter
4. Click the trash can to remove the filter

Number of Orders

The “Number of Orders” filter allows you to filter contacts based on the total number of orders they have placed.

1. Select Number of Orders is (Equals, Not equals, Less than, Less than or equal to, Greater than, Greater than or equal to )
2. Enter a value
3. Click the ✓ to apply the filter
4. Click the trash can to remove the filter

*You can use these filters together in combination

Reports

Need to identify your top-performing (and underperforming) emails and flows to understand what’s working and what’s not? Our WooCommerce integration lets you find out easily, without navigating complex settings.

To view the reports, go to: Groundhogg » Reporting » WooCommerce Tab

Available reports:

The WooCommerce report in Groundhogg tracks only orders generated through marketing activities within Groundhogg, such as flows, broadcasts, and tracked contacts. It is not a replacement for the standard WooCommerce reports dashboard, which should be used for general revenue reporting.

Since these reports are not retroactive, importing orders will not impact the Groundhogg WooCommerce report.

Additionally, Groundhogg WooCommerce reports are based on the subtotal, meaning taxes and discounts are not factored in. This makes the report a tool for measuring marketing success rather than an exact revenue tracker. For precise revenue data, refer to WooCommerce’s standard reports.

Replacement Codes

The Groundhogg-Woocommerce add-on contains six different replacement codes that you can use to send discount codes to contacts.

Tagging

When a customer buys a product, you can apply or remove tags within the product data. Tags are updated when the order is marked as paid or complete (whichever comes first), making it easy to track purchased products at a glance.

To configure this, edit your product and scroll to the Product Data section. Under the Groundhogg Integration settings, you can add or remove tags as needed.

Contact Metadata

Additional information about a Contact’s purchases can be found in the metadata box in the right column of each Contact. 

• Total Customer Value
• Successful Orders
• Order ID
• Order Status
• Order date
• Order Value
• Product name

Compliance

To help you maintain compliance, especially with regulations like GDPR, the extension adds a couple of key settings under Groundhogg » Settings » Integrations.

Require Marketing Consent at Checkout

• Enable: Requires customers to give marketing consent at checkout for GDPR compliance (works only if GDPR features are enabled in WooCommerce).
• Purpose: Ensures customers opt-in to marketing, safeguarding privacy and meeting legal standards.

Marketing Consent Checkbox Text

• Default Text: “I agree to receive marketing offers and updates from [your store].”
• Customization: Editable text shown on the checkout page when GDPR features are enabled.
• Purpose: Informs customers clearly, ensuring transparency.

Tools

If you were using WooCommerce before installing Groundhogg then the WooCommerce orders won’t be synced with the Groundhogg contacts. You can sync them using our Sync WooCommerce Orders tool, which you can find under Tools → Misc → Sync WooCommerce Orders. Click the [ Process ] button and please be patient while this sync process works, especially if you have lots of orders.

Woo Sync Order Processing Details.

• Woo Sync does not require a user account—guest orders are also synced. However, tags are only applied to paid orders.
• The only reason an order wouldn’t sync is if it has no associated billing email address.
• One limitation is that some WooCommerce functions for retrieving orders and order totals rely on a user account. As a result, certain search functions may not include contacts created from guest orders.

FAQs / Troubleshooting

Q: How can I add custom checkout fields from the WooCommerce Checkout Field Editor to Groundhogg contact records?
A: Add this code snippet to your theme’s functions.php file or a code snippets plugin.