Before you begin
For some ecommerce platforms, Added to Cart events are tracked automatically. For other ecommerce platforms, a code snippet must be manually added to your site.
Before consulting this guide, make sure you:
- Enable Added to Cart tracking, if it was not added automatically through your integration.
- Enable Klaviyo’s “Active on Site” JavaScript, known as Klaviyo.js, in order for Added to Cart tracking to work. Learn how in the "Active on Site" section below.
If you are using BigCommerce, make sure to enable Viewed Product tracking, which is required in order for Added to Cart tracking to function properly. Guidance around enabling Viewed Product tracking is given in the setup guides linked below. If you are experiencing issues with Viewed Product tracking, please see our guide on troubleshooting Viewed Product tracking.
The following ecommerce integrations support Added to Cart tracking, and it works as follows:
-
Shopify
Enabled via a Shopify Server Pixel when you check the Track behavioral events setting -
BigCommerce
Requires a manually installed code snippet -
Magento 2
Automatically added by Klaviyo -
WooCommerce
Automatically added by Klaviyo -
PrestaShop
Automatically added by Klaviyo -
Salesforce Commerce Cloud
Automatically added by Klaviyo - only tracked for logged-in users
If you’re using an ecommerce platform without a pre-built Klaviyo integration, or a custom platform, learn about how to enable Viewed Product and Added to Cart tracking on our Developer site.
Test Added to Cart trackingTest Added to Cart tracking
To test that your Added to Cart tracking is set up properly, follow these steps:
- Navigate to your website
- On your homepage, add the following to the end of the URL, replacing example@gmail.com with your email address:
?utm_email=example@gmail.com
- Reload the page
- Navigate to a product page on your site with a product that is in stock
- Click the “Add to Cart” button on the page
- Search in Klaviyo for the email address you used in step 2
You should see that a Klaviyo profile has been created for you (if one didn't exist already) and that an Added to Cart event has been tracked on your activity feed.
To see a feed of all Added to Cart metrics over time:
- Navigate to Analytics > Metrics in Klaviyo.
- Filter by Added to Cart to view tracked data in an activity feed, activity map, charts, best people, and cohort reports. Please note that for Shopify, Added to Cart will have a Shopify icon, but for all other integrations it will have a gear icon.
Once you’ve reviewed the troubleshooting scenarios below and made changes, you should test your tracking again to make sure it’s working correctly.
Troubleshooting scenariosTroubleshooting scenarios
Review the following questions in order to diagnose the cause of your Added to Cart issues. Note that some steps are general, and others depend on what ecommerce platform you are using.
Have you enabled Klaviyo’s Active on Site tracking?Have you enabled Klaviyo’s Active on Site tracking?
In order for Added to Cart tracking to work correctly, you must first enable Klaviyo’s Active on Site tracking which allows your customers to be cookied. Active on Site tracking is enabled via the addition of a JavaScript snippet (known as “Klaviyo’s onsite JavaScript” or “Klaviyo.js”) to your site.
Klaviyo adds Klaviyo.js automatically during the integration, though some integrations require that you check a setting to enable it. Learn about your specific ecommerce platform and how to test that Klaviyo.js is working:
-
Shopify
Klaviyo.js is added automatically through the integration or through the Klaviyo app embed in Shopify, if you enable it. Learn more about the app embed and onsite tracking for Shopify. -
WooCommerce
Klaviyo.js is added automatically when you integrate with WooCommerce, and you can make sure that you’ve completed all steps by reading our WooCommerce integration guide. To test your onsite JavaScript, click the account dropdown in your Klaviyo account and click Setup Web Tracking. Then, find the step where you can enter your site URL in the box, and follow the instructions to test your tracking. -
BigCommerce
Make sure you’ve checked the option on your integration settings page to Automatically add Klaviyo onsite JavaScript. Then, follow the steps to test your onsite JavaScript. -
Magento 2
Klaviyo.js is added automatically when you integrate with Magento 2, and you can make sure that you’ve completed all steps by reading our Magento 2 integration guide. To test your onsite JavaScript, click the account dropdown in your Klaviyo account and click Setup Web Tracking. Then, find the step where you can enter your site URL in the box, and follow the instructions to test your tracking. -
PrestaShop
Klaviyo.js is added automatically when you integrate with PrestaShop, and you can make sure that you’ve completed all steps by reading our PrestaShop integration guide. To test your onsite JavaScript, click the account dropdown in your Klaviyo account and click Setup Web Tracking. Then, find the step where you can enter your site URL in the box, and follow the instructions to test your tracking.
For Shopify users: have you enabled the app embed?For Shopify users: have you enabled the app embed?
Once you enable the app embed in Shopify and check the Track 'Viewed Product' events setting, Viewed Product tracking will turn on automatically. Read our article on enabling the Klaviyo app embed in Shopify for more information.
Have you recently switched ecommerce platforms?Have you recently switched ecommerce platforms?
If you’ve recently switched ecommerce platforms, you’ll need to add both Viewed Product and Added to Cart tracking to your new site. Consult the information in the Before you begin section above to learn about Viewed Product and Added to Cart tracking for your new platform.
Have you recently updated your store’s theme, or made any other updates to your ecommerce platform?Have you recently updated your store’s theme, or made any other updates to your ecommerce platform?
If you’ve recently updated your store’s theme, you may need to reinstall Klaviyo.js, the Viewed Product snippet, and the Added to Cart snippet (for BigCommerce) on your new theme depending on the platform. Making other updates to your ecommerce platform may also affect the snippets previously added to your site.
To reinstall the Viewed Product snippet for BigCommerce, follow the instructions in the BigCommerce integration setup guide, and for the Added to Cart snippet follow the guide to creating an "Added to Cart" event for BigCommerce.
If you’re using WooCommerce or Magento, or are using the Klaviyo app embed in Shopify, but you’ve made changes to your site and now the event isn’t tracking, you should contact Klaviyo support to help diagnose the problem.
For BigCommerce users: Is your ecommerce store connected to multiple Klaviyo accounts?For BigCommerce users: Is your ecommerce store connected to multiple Klaviyo accounts?
If you have one store connected to multiple Klaviyo accounts, this can cause problems with Active on Site, Viewed Product, and Added to Cart tracking. Duplicate Klaviyo.js can cause onsite tracking to break.
To check if you have duplicate Klaviyo.js:
- Navigate to your main theme file. Klaviyo.js looks like this:
<script type="text/javascript" async="" src="https://static.klaviyo.com/onsite/js/klaviyo.js?company_id=API_KEY"></script>
- If you search for company_id within the file and find it twice (and see two of the snippets shown above) then you have duplicate Klaviyo.js. There will typically be two different API keys after the equals sign, one from each Klaviyo account.
- To make sure the duplicate is removed correctly from your site, please contact Klaviyo support.
For BigCommerce users: Are you using the correct code snippet for your Add to Cart button?For BigCommerce users: Are you using the correct code snippet for your Add to Cart button?
BigCommerce requires a manually installed code snippet to use Added to Cart tracking. There are 2 different snippets that can be installed into your theme depending on if your “Add to Cart” button has an ID or not. Please see our guide on how to create an "Added to Cart" event for BigCommerce for more information on how to check this.
For WooCommerce and Magento users: Are you using the most recent version of your integration plugin?For WooCommerce and Magento users: Are you using the most recent version of your integration plugin?
If you are using WooCommerce or Magento, problems with Added to Cart tracking might be related to other issues with your platform’s Klaviyo plugin.
- If Added to Cart events aren’t tracking, check to see if the Started Checkout event is tracking by searching for Started Checkout within Analytics > Metrics in Klaviyo.
- If both Added to Cart and Started Checkout aren’t tracking, there may be an issue with your plugin.
- Check to see if you are using the most up-to-date version of the plugin for your integration. If needed, update to the latest version within WooCommerce or Magento, or you can download the latest version from the relevant platform’s listing.
For Shopify users: Do you require cookie consent for visitors in the EU, EEA, UK and Switzerland prior to permitting onsite tracking?For Shopify users: Do you require cookie consent for visitors in the EU, EEA, UK and Switzerland prior to permitting onsite tracking?
Based on your Customer Privacy settings in Shopify, Klaviyo may not track onsite events for visitors to your Shopify store in the EU, EEA, UK and Switzerland, unless they have provided consent.
Contact Klaviyo support
If you are still encountering issues after consulting this list and testing your tracking, please reach out in our Community or to our Support Team.
Additional resourcesAdditional resources
Learn how to troubleshoot other metrics:
- Troubleshooting Viewed Product tracking
- Troubleshooting Placed Order tracking
- Troubleshooting Started Checkout tracking
Other resources: