How to use WooCommerce data in flows

You will learn

Learn how to use data from Klaviyo's WooCommerce integration within your flow emails and SMS messages. When you integrate your WooCommerce account with Klaviyo, you'll have access to customer and purchase data that you can use to personalize your customers' experience.

To see what events we sync from WooCommerce, see our article on reviewing your WooCommerce data.

Pre-built flows

We offer a variety of pre-built flows in the Klaviyo flow library. To get there, head to Flows > Create flow in Klaviyo. These flows include all the event data you'll need pre-filled in each template. Some of our most popular pre-built flows for WooCommerce are listed in the table below:

Note that to use pre-built flows utilizing SMS, you must first set up Klaviyo SMS.

Build flows from scratch

1. To build a flow from scratch, navigate to the Flows tab in Klaviyo.
2. Click Create flow.
3. Select Build your own.
   

4. Name your flow and add any tags. Click Create manually if it appears. Otherwise, click Create flow.
5. Next, design your flow. You can trigger your flow based on any events synced from WooCommerce.
   

6. To learn more about flow triggers and filters, and adding steps to your flow, consult our Getting started with flows guide.
7. Next, you'll create flow email content (or SMS content if desired). Consult the section below to learn how to add personalization using WooCommerce event variables.
8. When you're done designing your flow emails, you're ready to learn how to set your flow live.

How to find event variables

Event variables in these messages come from the WooCommerce event that triggers the flow. Use a metric-triggered flow and make sure the metric has recorded an event before previewing its data.

Emails

To add event variables to a flow email you've created in the drag-and-drop editor:

1. In the flow builder, select the email you want to personalize.
2. In the Template section, click Edit.
3. Click Preview.
4. Under All properties > Event properties, click a property name to copy its tag.

5. Click Done to return to the editor, then paste the tag into your flow email.
6. Click Preview again to check that the event data appears as expected. When you're finished, click Done, then Exit to leave the editor.

The preview shows the data for the selected event, so values and available properties can differ between events. List entries are numbered starting at 0. For instance, {{ event.extra.Items.0.Name }} shows the first item's name in a WooCommerce Started Checkout event. The 0 indicates the first item in the list.

SMS

1. In the flow builder, click the SMS or MMS you want to add an event variable to.
2. In the Content section, click Edit.

In the message editor, you can add text, emojis, static or dynamic images, and GIFs to your message. Here, you can also insert profile personalization and event variables.

1. Click Preview. Use the arrows to choose from up to 10 recent events for the flow's trigger metric. For example, a post-purchase flow triggered by Placed Order shows recent Placed Order events.
2. Expand All properties and find Event properties to see the variables for the selected event.

3. Click a property name to copy its tag to your clipboard.

4. Click Done to return to the editor, then paste the tag into your message.
5. Click Preview again to check the personalized message. When you're finished, click Done, then Next to save and continue.

Common event variables for WooCommerce

The syntax for different event variables depends on both the integration and event metric. You can see the syntax for all of the available variables for a given event by scrolling through the preview window and clicking on the different entries.

Some common WooCommerce variables are listed below for a Started Checkout event. Keep in mind that the exact variable may differ depending on the metric used to trigger the flow.

You can rebuild carts from an abandoned cart flow in WooCommerce by using the parameter ?wck_rebuild_cart={{ event.extra.CartRebuildKey }}.

Are you using Amazon Buy with Prime?

If you're using Buy with Prime to power payment and fulfillment for any of the products on your store, you'll need to make some additions to your flows (whether pre-built or scratch), and create some new flows. First:

• Integrate Buy with Prime with Klaviyo to bring Buy with Prime data into your Klaviyo account.

For your abandoned "Started Checkout" flow:

• Create 2 separate abandoned cart flows: one triggered by WooCommerce's checkout event (the pre-built flow listed above), and one triggered by Buy with Prime's checkout event. For your Buy with Prime flow, read How to create an abandoned cart flow for Amazon Buy with Prime.
• For your WooCommerce abandoned cart flow, add the following profile filter to exclude customers who made purchases via Buy with Prime from receiving incorrect messaging:
  
  • Placed Order (Buy with Prime) zero times since starting this flow.

For your abandoned "Added to Cart" flow:

• Add the following profile filters to exclude customers who started checkouts or made purchases via Buy with Prime from receiving incorrect messaging:
  
  • Checkout Started (Buy with Prime) zero times since starting this flow AND
  • Placed Order (Buy with Prime) zero times since starting this flow.
• No second flow for Buy with Prime is needed, since Buy with Prime does not have an Added to Cart event.

For your browse abandonment flow:

• When you create your browse abandonment flow (you only need to create one flow, since it's triggered by the Viewed Product event) add the following profile filters to incorporate Buy with Prime data into your flow:
  • Checkout Started (Buy with Prime) zero times since starting this flow AND
  • Placed Order (Buy with Prime) zero times since starting this flow.

For your customer winback flow:

• Create 2 separate winback flows: one triggered by WooCommerce's Placed Order event (as listed above) and one triggered by Buy with Prime's Placed Order event to account for customers who placed their original order with Buy with Prime. For your Buy with Prime winback flow, read How to create a winback flow for Amazon Buy with Prime.
• When you create your WooCommerce winback flow, add the following profile filter to exclude customers who made purchases via Buy with Prime from receiving incorrect messaging:
  
  • Placed Order (Buy with Prime) zero times since starting this flow.

Additional resources