Troubleshooting placed order tracking

Estimated 6 minute read

Updated Aug 29, 2024, 9:57 PM EST

Placed Order tracking is included with 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.

For all ecommerce integrations, a Placed Order event tracks when a customer completes the checkout process and creates an order in your store, but for the following integrations, Klaviyo tracks a Placed Order event only when an order reaches a certain state and has a certain status in the eCommerce platform:

BigCommerce
By default, any order with any of the following statuses will not sync as a Placed Order: Incomplete, Pending, Awaiting Payment
Magento 2
Orders with status pending_payment will be ignored
WooCommerce
Order must have a status of processing to trigger a Placed Order event
PrestaShop
Order must have a status of processing to trigger a Placed Order event
Shift4Shop
Order must have a status of 2 or 4 to trigger a Placed Order event

If you’re using an ecommerce platform without a pre-built Klaviyo integration, or a custom platform, learn how to enable Placed Order tracking on our Developer site.

Test Placed Order events

The Placed Order event is commonly used to set up post-purchase flows such as a thank you flow. If you have recently set up your account and are attempting to create a post-purchase flow from Klaviyo’s Flows Library, you may encounter the following warning message:

"We have not received any recent Placed Order events. If you think there might be a problem, contact our Success Team for help."

This does not necessarily mean that there is a problem with your account or integration, but it may mean that no Placed Order events have triggered yet. This may be because your store is new. You can trigger an event by following the steps below to cause this warning to disappear.

Because a Placed Order event triggers from a transaction, Klaviyo Support is unable to test Placed Order event tracking for you.

Some ecommerce platforms such as Shopify offer methods for placing test orders. Consult your platform’s help documentation for information on how to place a test order. Otherwise, you can place a real order and refund it to test your integration.

To test that your Placed Order tracking is set up properly using a real transaction, follow these steps:

Navigate to your website
Navigate to a product page on your site for an available product
Click the “Add to Cart” button on the page
Proceed to checkout with the item in your cart
Complete checkout using a real credit card or other payment method
If you're using a third-party payment provider, log into your payment provider to make sure that the funds were processed
Cancel and refund the order as soon as possible to refund yourself
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 Placed Order 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.

Troubleshooting scenarios

Review the following questions in order to diagnose the cause of your Placed Order issues. Note that some steps are general, and others depend on what ecommerce platform you are using.

Are you having issues triggering other metrics as well?

If you are having issues tracking other metrics as well as Placed Order, there may be an issue with your integration’s setup.

Follow these steps to check 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 any 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.

Have you recently switched ecommerce platforms?

When you migrate ecommerce platforms, make sure to switch the metrics used to trigger your flows and within your 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 Placed Order metric rather than Shopify’s Placed Order metric. See the guides below for further assistance:

Are you using custom order statuses for placed orders?

For some integrations, the Placed Order event triggers in Klaviyo based on specific order statuses. See the Before you begin section of this article for a list of integrations that have order status requirements.

If you are using non-standard or custom order statuses, please contact Klaviyo support to have your integration configuration changed to allow for other order statuses to be tracked as Placed Order events.

Are you using a firewall or security software on your server?

If you have a firewall or security measures enabled such as Sucuri, Cloudflare, or something similar, this may inadvertently block Klaviyo from communicating with your store or rate limit the speed and amount of data that can be synced.

Since Klaviyo uses dynamic IPs, we do not provide a range of IPs to whitelist. Instead, we recommend whitelisting our user agent, which is: Klaviyo/1.0

If you are unsure how to whitelist Klaviyo, please consult the documentation for your security software on how to whitelist a user agent.

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 Placed Order tracking might be related to other issues with your platform’s Klaviyo plugin.

If Placed Order 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 Placed Order 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.

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

Learn how to troubleshoot other metrics:

Other resources:

Was this article helpful?

Use this form only for article feedback. Learn how to contact support.

Explore more from Klaviyo

Community

Connect with peers, partners, and Klaviyo experts to find inspiration, share insights, and get answers to all of your questions.

Visit Community

Live training

Join a live session with Klaviyo experts to learn about best practices, how to set up key features, and more.

Support

Access support through your account.

Email support (free trial and paid accounts) Available 24/7

Chat/virtual assistance
Availability varies by location and plan type