You will learn

Learn best practices for when to use and create custom metrics. By default, Klaviyo provides metrics that track your business’s performance and measure success (e.g., a Placed Order event). However, there may be instances where you need to create custom metrics to more accurately capture how your business runs. For example, your Placed Order events may include recurring subscriptions, and you’d like to review only one-time orders. This article walks you through common use cases for creating different types of custom metrics.

For information on setting up custom metrics, visit our guide on configuring custom metrics.

Please note that this guide walks through the most common use cases, but does not reflect all the potential possibilities of custom-created metrics.

Custom metrics cannot currently be used in segmentations, triggering, splitting, or filtering flows, or found on a profile itself. Custom metrics are currently limited to a subset of reports. More information on where to find custom metric information in reporting is noted below.

Before you begin

Depending on your subscription provider, e-commerce integration, or e-commerce platform implementation, your custom metric creation may differ slightly.

For customers using Klaviyo’s marketing application, you have access to create 1 custom metric. For customers also using Advanced KDP or Personalization, you have increased flexibility to create up to 50 custom metrics. To learn more about these plans, head to our billing guide.

A custom metric creates a new reporting option without changing the original metrics or events. It can combine up to 5 metrics, with up to 3 filters per metric. All filters on a metric must match for an event to be included.

Reports that can use custom metrics

When you adjust a custom metric, reporting that uses it updates. Edits to a custom metric used in CLV, RFM, or product analysis may take up to 24 hours to appear. You can use custom metrics in the following reports:

The audience performance dashboard does not offer custom metrics in its conversion metric dropdown.

Removing or excluding certain events

There may be instances where you want to separate out certain events from your default metrics to analyze performance more accurately, especially if you are on an integration that automatically combines different customer events—like recurring and one-time purchases, or in-store and online purchases. This way, you more accurately analyze what marketing strategies are contributing to your revenue.

The sections below walk through these in more detail, depending on your integration and needs.

Removing recurring subscription events

Shopify, WooCommerce, and BigCommerce can include subscription orders in Placed Order when your subscription provider creates orders in that platform. To exclude recurring orders, choose a property and value that identify them in your event data. For example, if the text property Source Name is subscription for these orders, set Relationship to does not equal and Value to subscription. Use the actual value sent by your provider, which may differ from this example.

source name does not equal subscriptoin.jpg
source name does not equal subscriptoin.jpg

BigCommerce added Source Name to order events in December 2023. Its value comes from the external source when one is supplied, or otherwise from the order source. Check recent Placed Order events for the value to use. If older events are missing this property, contact Klaviyo Support before deleting order data or running a historical sync.

Separating retail and ecommerce events (Shopify or other custom integrations)

With Shopify and some custom integrations, physical retail (POS) and ecommerce orders come through under the same metric (e.g., Shopify Placed Order).

To exclude Shopify point-of-sale orders, filter Source Name with Relationship set to does not equal and Value set to pos. This excludes POS orders from the custom metric while leaving the original Placed Order metric unchanged. For a custom integration, use the property and value that identify its retail orders.

source does not equal pos.jpg
source does not equal pos.jpg

Separating certain brands or types of products purchased

If your business has certain sub-brands or product types within your catalog, you may find that you want to see the data of some types vs. others. For example, if your company sells third-party products besides your own, you may want to see how revenue compares between your products and these third-party ones.

You can exclude orders containing third-party products by filtering a product or brand property included in your Placed Order events. For a list property, use doesn't contain with the value you want to exclude. This removes the entire matching order, including any of your own products in that order. It does not subtract only the third-party products’ revenue. To compare revenue from individual products in mixed orders, use a product-level purchase metric, such as Ordered Product, with the relevant product properties.

metric third party does not contain.jpg
metric third party does not contain.jpg

Capturing or combining events

You may run a business that has many types of revenue or customer events, outside of the default Klaviyo events.

For example, you may have a business that includes:

  • A subscription model (and you are not on an integration that automatically adds these to your Placed Order events)
  • Paid virtual classes
  • Lead generation or sign-ups in person
  • In-person point of sale/physical retail locations (where the data is held in different systems or integrations).

The sections below explain how to combine revenue sources that are already recorded in Klaviyo. Before combining metrics, check that they do not count the same purchase twice. For example, adding a subscription purchase metric to Placed Order will overstate revenue if both already record that subscription purchase.

  1. Navigate to Analytics > Metrics and click Create custom metric. Enter a Name that describes the sources you are combining.
  2. Choose Value under Aggregated by for revenue, or Count for non-revenue events such as lead generation or sign-ups. In Define, select your first source under Metric name. If you chose Value, select its numeric Metric value property.
  3. Click Add metric to include another source. Select its metric and, for revenue reporting, its value property. Add filters only where you need to narrow the events included from that source.
  4. Click Preview metric to check the results, then Create metric to save.
  5. Select the saved custom metric in a supported report to view the combined results. It appears as a new reporting option and does not replace the original Placed Order metric.

Adding in subscriptions

For Shopify, BigCommerce, or WooCommerce

With standard Shopify integrations (not including headless implementations), BigCommerce, and WooCommerce, subscription orders can already be included in Placed Order when the subscription provider creates orders in the ecommerce platform. Check your existing events before adding a separate subscription purchase metric, so you do not count the same purchase twice. To exclude recurring orders, use the guidance above on removing subscription events.

For subscriptions tracked in a separate metric

Use Add metric to combine the metric recording subscription purchases with your ecommerce Placed Order metric. A Source Name filter only selects matching events within the metric it is applied to; it does not add purchases from another metric. If Source Name is a text property, choose is equal to with your actual subscription source value. The contains relationship is available for list properties.

source namd contains subscription.jpg
source namd contains subscription.jpg

Magento2 and WooCommerce pass their data in a way that makes it challenging for Klaviyo to accurately recognize subscription reporting. In these instances, it may not make sense to create subscription-specific custom metrics.

Adding in other non-subscription revenue events

For any integration

If your business earns revenue from live events, classes, webinars, or other sources, you can combine the metrics that record those purchases with Placed Order in a custom metric.

Use Add metric to include the metric that records class purchases, following the steps above. If those purchases already arrive within Placed Order, use the existing metric without adding a second copy. A Source Name filter for live classes selects only those matching events; it does not also include unrelated website orders. For a text property, use is equal to with the actual source value; use contains only for a list property.

source name contains live class.jpg
source name contains live class.jpg

Additional resources

  • How to configure custom conversion metrics

    Learn how to create custom metrics to more accurately track the impact of your marketing and how customers drive conversions. By default Klaviyo provides many metrics (e.g., Placed Order) to track your business’s success. However, if you have a custom setup or a different business use case, these default metrics may not work for you. For example, your Placed Orders events include recurring subscriptions, and you’d like to review only orders placed through your ecommerce website. The guide below walks you through how to set up these custom metrics for your needs.

  • Analytics glossary

    The glossary below defines common terms and acronyms used in Klaviyo analytics and data offerings.

  • How Klaviyo billing works

    Learn how Klaviyo bills customers for Profiles and Emails, Mobile Messaging, Reviews, Advanced Klaviyo Data Platform (formerly “CDP”), Marketing Analytics, Customer Hub, Helpdesk, and Customer Agent.

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.
Partners
Hire a Klaviyo-certified expert to help you with a specific task, or for ongoing marketing management.
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