You will learn

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.

If you need help on deciding when you should use custom metrics, head to our strategic guide on using custom metrics.

Before you begin

It’s important to note when you create your own custom metrics (e.g., Placed Order that excludes subscriptions), they will appear as a new metric option in Klaviyo reporting (i.e., it will not replace the default Placed Order metric).

Mapped metrics

You also have the option to utilize custom metrics within your mapped metrics. This helps ensure your generated predictive models and default reports are aligned to your account’s data structure and needs. For example, you may create a custom Placed Order metric that is then used to calculate applicable reporting using this metric.

Reports that can use custom metrics

And any time you adjust a custom metric, applicable reporting will update. Reporting where you can use this custom metric includes:

Using tags

Also, tags from your ecommerce integration, as well as other integrations, may not always reliably ingest correctly into Klaviyo. It is advised to avoid using tags in your custom metrics and events setup.

Default custom metrics

For Personalization and Advanced KDP customers, Klaviyo can automatically create default custom metrics when the required integration events are available. Newly created defaults appear in the Metrics tab. If you do not use either product, head to the next section on creating your metrics.

The following ecommerce and partner integration combinations support default custom metrics:

Newly created subscription defaults include the integration names. Existing defaults may have older names.

Ecommerce integration

Partner integration

Default custom metric created in your account

Metrics used

Metric definition

Any ecommerce integration whose mapped Placed Order metric includes a Source Name property with the value pos.

Not applicable

Placed Order - Online

Your mapped Placed Order metric.

Placed Order events not including any point of sale (POS).

Placed Order - In Store

Your mapped Placed Order metric.

Placed Order events made via point of sale (POS), identified by a Source Name value of pos.

BigCommerce

w/OrderGroove

Non-Recurring Order (BigCommerce Ordergroove)

Placed Order via BigCommerce

Placed Order events made on BigCommerce, not including any from OrderGroove.

Shopify

w/OrderGroove

Non-Recurring Order (Shopify Ordergroove)

Placed Order via Shopify

Placed Order events made on Shopify, excluding events whose Source Name starts with subscription_contract.

BigCommerce


w/Recharge


Non-Recurring Order (BigCommerce Recharge)

Placed Order via BigCommerce

Placed Order events made on BigCommerce, not including any from ReCharge.

One-time product added on Recharge via Recharge, if available.

One-time product added to an order through ReCharge only.

Subscription started on ReCharge via ReCharge.

Subscriptions created on ReCharge only.

Shopify


w/ReCharge


Non-Recurring Order (Shopify Recharge)

Placed Order via Shopify

Placed Order events made on Shopify, excluding events whose Source Name starts with subscription_contract.

One-time product added on Recharge via Recharge, if available.

One-time product added to an order through ReCharge only.

Subscription started on ReCharge via ReCharge.

Subscriptions created on ReCharge only.

Shopify

w/Skio

Non-Recurring Order (Shopify Skio)

Placed Order via Shopify

Placed Order events made on Shopify, excluding events whose Source Name starts with subscription_contract.

Skio: New Subscription Created via Skio

Subscriptions created on Skio only.

Creating a new custom metric

For customers using Klaviyo’s marketing application, you have access to create 1 custom metric. For customers also using Klaviyo Personalization or Advanced KDP, you have increased flexibility to create up to 50 custom metrics. Automatically created default custom metrics do not count toward this limit. To learn more about adding Klaviyo Advanced KDP, head to our billing guide.

  1. Navigate to Analytics > Metrics.
  2. In the upper right, click Create custom metric. Next, you will see the page to set up your new custom metric.
  3. Under Details, create and enter the name of your new metric. Use a name that will help you easily identify what this metric captures (e.g., “Orders placed w/ subscriptions”).
Custom metrics, details name.jpg
Custom metrics, details name.jpg
  1. Click the Aggregated by dropdown and choose how you want to calculate your metric (either by Value or Count). For example, if you want to capture revenue from Placed Order events, use Value to show the revenue output. If you want to redefine email clicks, use Count.
aggregated by dropdown.jpg
aggregated by dropdown.jpg
  1. In the Define section, click the Metric name dropdown and select the source metric to include. These include Klaviyo and integration-specific events and metrics.
metric naem dropdown fina;.jpg
metric naem dropdown fina;.jpg
  1. If you selected Value under Aggregated by, choose the numeric property to total in the Metric value property dropdown, such as the order value for Placed Order events. This field is not shown when you select Count. Use filters in the following steps to include or exclude subscription orders.
metric value dropdown, update.jpg
metric value dropdown, update.jpg
  1. If applicable, click Add filter to further define your filters and metric definition.

If applying multiple filters, they must all be true for an event to qualify.

  1. If you added a filter, choose the event property to filter in the Property field, such as Source Name.

    Once you have chosen your property, the Type field will automatically determine how it will be represented (e.g., number, text, etc.).
property dropdown, final.jpg
property dropdown, final.jpg
  1. Click the Relationship dropdown and choose how to compare the property’s value. For example, to exclude events whose Source Name is “non-paid marketing subscription,” select does not equal.
relationship dropdown final.jpg
relationship dropdown final.jpg
  1. If your selected relationship requires a value, select or enter it in the Value field. For the example above, enter “non-paid marketing subscription.”
  2. Optional: Click Add metric in the Define section to combine another source metric. Repeat the metric selection and filter steps for each source. You can combine up to 5 metrics, with up to 3 filters per metric.

You can choose up to 3 filters for each source metric. It’s important to note that depending on what combination of properties and filters you use, you may run into instances where the configuration you chose inadvertently duplicates values. For example, a customer order includes a subscription and a retail good from your website. When a customer places this order, your Klaviyo account receives 2 unique events (one for the subscription and one for the website order). If you include a revenue value in your new definition and replicate it for the subscription, Klaviyo will count both events as a conversion and inflate the attributed revenue (as both are now mapped to the same custom metric).

  1. Optional: Click Preview metric to check that your metric captures what you need. The preview shows a bar chart for the last 30 days on the left and an Activity log with up to 10 recent matching conversion events on the right.
  2. When you are ready to save your new metric, click Create metric.
  3. Return to Analytics > Metrics to find your new metric.

Editing a previously created custom metric definition

  1. If you have previously created a custom metric definition and need to update it, head to Analytics > Metrics.
  2. From the list find the metric you want to edit and click on it.
  3. Click Edit definition in the upper right. You will return to the setup page from here, where you can adjust your definition, including filters, relationships, and values. Follow the instructions above to adjust these as needed.
  4. Click Update metric to save your changes. You will return to the metric’s page.

Deleting a previously created custom metric definition

If the custom metric is used in mapped metrics, change its mapping to another metric before deleting it.

  1. Head to Analytics > Metrics.
  2. In the list, find the metric you want to delete and click the 3 dot menu to the right and select Delete.
custom metrics, delete metric.jpg
custom metrics, delete metric.jpg
  1. Click Delete in the confirmation dialog. Check that the metric no longer appears in Analytics > Metrics.

Additional resources

  • Understanding when and how to use custom conversion metrics

    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 Orders events include recurring subscriptions by default, and you’d like to review only orders placed through your ecommerce website. This article walks you through common use cases for creating different types of custom metrics.

  • 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