Before you begin
Started Checkout tracking is included with many ecommerce integrations and does not require any additional setup. Before consulting this guide, make sure you have properly set up, configured, and enabled your ecommerce integration.
It is important to understand how Started Checkout events trigger for different integrations. See the list below for a quick overview on how each ecommerce integration triggers the event. You can click on the name of each integration to learn more.
-
Shopify
Referred to as Checkout Started and tracks after a customer fills out the email address field on the checkout page. This applies to both one-page checkout and multi-page checkout. -
BigCommerce
Tracks when a customer enters their contact and shipping information on the first page of the BigCommerce checkout process and clicks “Continue” -
Magento 1
Referred to as Checkout Started and tracks when a customer enters their contact and shipping information on the first page of the Magento checkout process and clicks “Continue” -
Magento 2
This event only tracks if the customer does not proceed to place an order by the time a Magento 2 periodic sync occurs (which happens every 30 minutes.) For example, if a customer starts checkout right after the last periodic sync but does not complete checkout within 30 minutes, a Started Checkout event is sent to Klaviyo. If they proceed to place an order within those 30 minutes, a Started Checkout event will not be recorded, and a Placed Order event will track instead.
This event tracks when one of the following occurs: - A customer is logged into their account, adds something to their cart, then views the checkout page
- A customer who is not logged in adds something to their cart, views the checkout page, and enters a billing email address
-
WooCommerce
Tracks when one of the following occurs: - A customer is logged into their account, adds something to their cart, then views the checkout page
- A customer who is not logged in adds something to their cart, views the checkout page, and enters a billing email address
-
PrestaShop
Tracks when one of the following occurs: - A customer logs into their account, adds something to their cart, and navigates to the checkout page
- Without logging in, or using guest checkout, a customer adds something to their cart, navigates to the checkout page, and enters their email address
-
Shift4Shop
Tracks when a customer enters their contact and shipping information on the first page of the Shift4Shop checkout process and clicks “Continue”
If you’re using an ecommerce platform without a pre-built Klaviyo integration, or a custom platform, learn how to enable Started Checkout tracking on our Developer site.
Test Started Checkout eventsTest Started Checkout events
The Started Checkout event is commonly used to set up abandoned cart flows. If you have recently set up your account and are attempting to create an abandoned cart flow from Klaviyo’s Flows Library, you may encounter the following warning message:
"We have not received any recent Started Checkout events. If you think there might be a problem, contact our Success Team for help."
This does not necessarily mean there is a problem with your account or integration, but it may mean no Started Checkout events have triggered yet. If your site is new, this is most likely the case. You can trigger an event by following the steps below to cause this warning to disappear.
To test your Started Checkout tracking is set up properly, follow these steps:
- Navigate to your website.
- Navigate to a product page on your site with a product in stock.
- Click the “Add to Cart” button on the page.
- Proceed to checkout with the item(s) in your cart.
- On the first page of checkout, fill out all required contact information and click Continue to move to the next step of the checkout process.
- Search in Klaviyo for the email address you used during checkout
You should see that a Klaviyo profile has been created for you (if one didn't exist already) and that a Started Checkout event has been tracked on your activity feed.
Not all ecommerce integrations sync data in realtime due to limitations with some ecommerce platforms. For some integrations, you may need to wait 30 minutes to an hour before events are tracked. Please see our article on how often integrations sync for more information.
To see a feed of all Started Checkout metrics over time:
- Navigate to the Analytics tab of your account.
- Click into Metrics.
- Filter by Started Checkout (or Checkout Started for Shopify and Magento 1) to view tracked data in an activity feed, activity map, charts, best people, and cohort reports.
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 Started Checkout issues. Note that some steps are general, and others depend on what ecommerce platform you are using.
Are you having issues tracking other metrics as well?Are you having issues tracking other metrics as well?
If you are having issues tracking other metrics as well as Started Checkout, there may be an issue with your integration’s setup.
Follow these steps to see if your integration is set up correctly:
- Navigate to the Integrations page of your account.
- In the Enabled Integrations tab, make sure that your ecommerce integration is in the list. Otherwise, follow the relevant setup guide linked in the Before you begin section of this article to make sure you have followed all steps correctly for setting up and configuring your ecommerce integration.
- If your ecommerce integration is enabled, click View Settings to check for error messages related to the integration and that all required fields have been filled out.
- If your integration requires use of a public API key, private API key, consumer key, and/or consumer secret, make sure the information in Klaviyo matches what is in your ecommerce platform.
- If the keys appear to match on both sides, check to see if there are any blank spaces before or after the keys. Delete any leading or trailing blank spaces because they can cause errors.
- If you are still encountering issues with your integration, please contact Klaviyo support for further troubleshooting.
Have you recently switched ecommerce platforms?Have you recently switched ecommerce platforms?
When you migrate ecommerce platforms, make sure to switch the metrics used for your flows and analytics to the metrics for your new ecommerce platform. For example, if you were to switch from BigCommerce to Shopify, your account’s analytics and flows may still be set to use BigCommerce’s Started Checkout metric rather than Shopify’s Started Checkout metric. See the guides below for further assistance:
Are you using a third-party service for your checkout page?Are you using a third-party service for your checkout page?
If you are using a third-party app or extension to handle your checkout process, this may prevent checkout events from triggering properly for your ecommerce platform which will in turn prevent Klaviyo from tracking Started Checkout events.
In order to test for this, try disabling the app or extension responsible for managing your checkout process and see if you are able to trigger a Started Checkout event using the steps provided in the Test Started Checkout events section of this guide.
For Wix users: Does your store use a single page for checkout?For Wix users: Does your store use a single page for checkout?
In order for Klaviyo to track Started Checkout events on Wix, the shipping and billing info must be on separate pages. If you have a single page checkout process, it is recommended that you adjust any settings, theme, or extension to ensure your checkout process requires the customer to enter information on multiple pages.
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 Started Checkout tracking might be related to other issues with your platform’s Klaviyo 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.
- Klaviyo WordPress (WooCommerce) plugin
- Klaviyo Magento 1 extension
- Klaviyo Magento 2 extension
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 resources