Getting started with WooCommerce

You will learn

Learn how to install the Klaviyo WooCommerce plugin and enable the WooCommerce integration in your Klaviyo account.

The main steps to integrating with WooCommerce are:

• Install the Klaviyo plugin in WooCommerce
• Enable the WooCommerce integration in Klaviyo

This article also guides you through testing your WooCommerce integration. 

The WooCommerce integration syncs data to Klaviyo in real time.

How-to video

Install the Klaviyo plugin in WooCommerce

Klaviyo’s WooCommerce plugin allows you to add a newsletter sign-up form to your website, enable website activity tracking, and get data about when people start checkouts and view products so you can send out abandoned cart emails.

Before you begin, we recommend that you log in to your Klaviyo and WooCommerce accounts. If you have more than one Klaviyo account, log out of any accounts you don’t wish to integrate with WooCommerce.

Starting in WooCommerce

The Klaviyo plugin can be installed directly from WooCommerce.

1. In WooCommerce, click into the Plugins tab and select Add New at the top of the page. You can also hover over the tab from the left-hand navigation and click Add New from the pop-up menu.
   
2. On the Add Plugins page, search for Klaviyo.
3. Click Install Now.
4. Click Activate to activate the plugin. Your plugin is now installed.

5. In WordPress, navigate to Plugins.

6. Scroll down to find the Klaviyo plugin and click Settings.

7. Click Connect Account to begin, then proceed to Enable the WooCommerce Integration in Klaviyo. 
   

Starting in Klaviyo

You can also install the Klaviyo plugin from within your Klaviyo account. This method requires you to download the plugin file. Skip over this section if you have already installed the plugin from within WooCommerce, and head to Enable the WooCommerce Plugin in Klaviyo.

1. In Klaviyo, navigate to the Integrations tab. Search for WooCommerce and click Add Integration.
2. On the next page, click Integrate with WooCommerce to be redirected to the WordPress download page for the Klaviyo plugin. Click Download in the upper right corner to begin downloading the .zip file.
3. In WooCommerce, click into the Plugins tab and select Add New at the top of the page. You can also hover over the tab from the left-hand navigation and click Add New from the pop-up menu.
   
4. On the Add Plugins page, click the Upload Plugin button at the top to expand the upload options. Click Choose File and select the .zip file you downloaded in the previous steps.
   
5. When you've located the Klaviyo plugin .zip file, confirm the file name is correct and then click Install Now.
6. On the next page, ensure you see the confirmation message Plugin installed successfully. Once this message displays, click Activate Plugin to finalized plugin installation.
   
7. Click Connect Account to begin. You will be redirected back to Klaviyo to connect your account to the new plugin. 
   

Enable the WooCommerce integration in Klaviyo

1. If prompted, log in to Klaviyo. You can make sure that you are logged in to the correct Klaviyo account by opening a new tab, navigating to your Klaviyo dashboard, and checking the account name.
   If you need to switch accounts, click Logout and then log in to the correct account before proceeding.
   When you are ready, grant Klaviyo read/write permissions by clicking Approve.
   
2. You’re almost done! The Klaviyo installation wizard will walk you through the final steps to connect WooCommerce to your Klaviyo account. On the integration settings page, confirm the account name is correct.

Subscriptions

3. Check the box next to Collect email subscribers to easily add this option to your WooCommerce site.

• • Select a list from the dropdown under Add email subscribers to this list. If no lists are available in the drop down, head over to the Lists & Segments tab to create a new list.
    Anyone who subscribes via the checkbox during checkout will be added to this list. Consent is sent to Klaviyo after the customer clicks the submit order button during checkout.
  • Under Email marketing consent label, enter the consent language you wish to appear next to the checkbox on your checkout page. The default language is Sign me up to receive Email updates and news

4. Check the box next to Collect SMS subscribers if you want to add this option to your WooCommerce site.

• • Select a list from the dropdown under Add sms subscribers to this list. Users who consent to SMS marketing via this checkbox will be subscribed to the list you select. Consent is sent to Klaviyo after the customer clicks the submit order button during checkout and the order is created in WooCommerce.
  • Under SMS marketing consent label, include the text you wish to appear next to the checkbox on your checkout page.
  • Next, add SMS consent disclosure text, which is required for TCPA compliance. Use the default Klaviyo consent language or add your own.

Advanced

5. If you wish to convert all future Placed Order and Ordered Product events to a selected currency, check the box for Convert all currencies to one standard currency. This will not apply retroactively to previously placed orders that sync to Klaviyo.
6. When you are satisfied with these settings, click Connect to WooCommerce. You can go back and edit these settings at any time by navigating to the Integrations tab, searching for WooCommerce, and clicking View Settings.

Congratulations! Your WooCommerce account is now connected to Klaviyo. Check out the setup wizard for a few recommendations on what to do next. When you’re finished, click Go Back to Klaviyo to return to your dashboard.

Troubleshooting

If you received an error message "Unable to test API by fetching order count. Invalid count" this means that when Klaviyo tries to validate the WooCommerce integration and get a count of orders, their API doesn’t return a value Klaviyo expects or it returns nothing at all. Since the integration hasn't officially connected to Klaviyo yet, this means that it needs to be resolved within WooCommerce.

To get more information about this error, use an application like Postman to make an API call to the order count endpoint which will provide more insight into what is being passed to Klaviyo.
The endpoint you need is: {customers-url}/wc-api/v1/orders/count
Change {customers-url} to your WooCommerce store URL.

Test your WooCommerce integration

To test out your integration and plugin, go to your website and follow these instructions:

1. Add an item to your cart.
2. Proceed to the checkout page.
3. Fill in your email address and phone number on the checkout page. If enabled, check the boxes to subscribe to email and SMS marketing.
4. Submit your test order.
5. Check for the following (these may take a minute or two to update):
• Started Checkout event logged under Recent Data
• Profile created in the lists you selected for email and SMS marketing
• Placed Order event logged under Recent Data

Recent data

The Recent Data section displays the most recent instance of an event.

Historical data

The Historical Data Progress bar updates in real-time as your historical sync is processed.

Next steps

Congratulations on getting set up! With your account setup and integrated, it's time to start using Klaviyo's core features. After you are done with the items in this category you'll be all set to get the most out of Klaviyo's features. Check out our Getting Started Handbook to ensure you're up and running to get the most from your Klaviyo account.

Rebuilding carts from an abandoned cart flow

You can use WooCommerce Data to Rebuild Carts from an Abandoned Cart Flow.

We will generate a key on the Started Checkout event that allows you to create a link that rebuilds the customer's cart in case they return to their cart via an email triggered by this event on another device. You can create this link using the following url parameter in an Abandoned Cart flow email triggered by a Started Checkout:

/cart?wck_rebuild_cart={{ event.extra.CartRebuildKey }}

Assembled, the url should look like the following:

{{ organization.url|trim_slash }}/cart?wck_rebuild_cart={{ event.extra.CartRebuildKey }}

The dynamically-generated product title link pulls directly from the URL you have inserted in your account settings. If needed, this URL can be updated in the email template editor.

Using WooCommerce Subscriptions Data

Learn about using WooCommerce Subscriptions Data in Campaigns and Flows.

Install plugin updates

Plugin updates can now be installed directly. When an update is available, you'll see an alert next to your Plugins tab.

1. Click on the Plugins tab. Scroll down to find the Klaviyo plugin.
2. If a new update is available, you’ll see an alert below the plugin details. Click update now.

If you prefer, you can still download the Klaviyo WooCommerce plugin manually from the Wordpress store.

Find the release notes

Release Notes are bundled with each new plugin update. View the ChangeLog file included with each WooCommerce plugin update for details.

To find your WooCommerce Plugin Release Notes:

1. select Plugins from your WooCommerce Admin page
2. scroll down to find the Klaviyo plugin
3. Click View Details
4. select the Changelog tab

How do I upgrade my WooCommerce integration to real-time, if I integrated using the Legacy API?

To start,install the latest WooCommerce plugin by following the plugin installation steps described above. Next, create a REST API key for the v3 integration with read/write permissions. This is different from the Legacy API key you created when you first installed the plugin.

Update your integration in Klaviyo by selecting Update Settings on the WooCommerce integrations settings page.

Please note that in order to use WooCommerce’s API v3 you must be on WC Version 3.5x or later and WP Version 4.4 or later.

Additional resources

• Pasting a form's embed code in WooCommerce
• WooCommerce data reference
• How to use WooCommerce data in flows
• Klaviyo Community: WooCommerce "Ask Me Anything" Question and Answer Video