This guide covers:
Why Klaviyo Custom Metrics don't sync to Hiro
How to recreate them using Default Order Filters
A quick tour of the filter options available
Why Klaviyo Custom Metrics don't sync to Hiro
Klaviyo's default metrics (like Placed Order from your e-commerce integration) are real events flowing in from your store — and those pass through to Hiro cleanly.
Custom Metrics are different. They're not new events — they're filtered views of existing metrics that live only inside Klaviyo.
For example, a "Placed Order excluding subscriptions" Custom Metric isn't a separate data stream; it's the regular Placed Order event with a filter applied on top. That filter definition stays in Klaviyo and doesn't travel with the data.
So instead of syncing the Custom Metric itself, Hiro recreates the same filtered view using Default Order Filters — same underlying data, same result, just configured on Hiro's side.
Put simply: Klaviyo Custom Metric = Hiro Default Order Filter. If you can describe the filter in Klaviyo, you can rebuild it in Hiro.
Recreating your Custom Metric in Hiro
Default Order Filters live under Account → Client Settings → Default Filters. From there you can include or exclude orders based on:
Order Sources — e.g. exclude
subscription_contractandsubscription_contract_checkkout_oneto remove recurring subscription revenueFull guide on how to filter out recurring subscription revenue here
Order Currency — filter to a specific currency if you report in multiple
Line Items — include or exclude orders containing specific products
Order Tags — include or exclude Shopify order tags
Discount Codes — include or exclude orders that used specific codes
By default, all clients will have All Orders as the default setting unless otherwise updated.
Before applying, use Preview Filter Changes to see what the filtered view will look like in your selected date range.
No Filters Applied — all order sources included
Current Filters — only the sources and filters you've selected
Change — the difference between the two columns, showing the filter's impact
Once you're happy with it, apply the filter and it becomes your default across all reporting views. Data will take 10-15 minutes to recalculate according to new filters. When the change is pending it will have a blue notice like this:
Once it is complete it will change to a green notice like this:
Finding the right Order Sources to filter
If you're not sure which Order Sources to include or exclude, the Order Source Explorer breaks down your revenue by source so you can see exactly what's coming from where before you filter.
A note on the numbers: The Order Source Explorer reports attributed revenue based on order date, while the Preview Filter Changes view uses the attribution window from your selected date range. The two can differ slightly for the same period — this is expected. Use the Preview view as your source of truth when deciding whether to apply a filter.
Order Source reference
Order Source | What it means |
All Orders | Everything — recurring revenue included. |
Web | Native Shopify checkout. Includes the first purchase of a subscription but excludes recurring renewals. |
Subscription Contract | Recharge recurring charges (legacy flow). |
Subscription Contract Checkout One | Recharge recurring charges (newer flow, rolled out October 2025). Most businesses now see a mix of both. |
Draft Orders | Manual orders created in Shopify admin. |
POS | Physical retail orders via Shopify POS. |
Third-party apps / API / manual uploads | Facebook Shop, Instagram, TikTok, custom integrations. Often shown as a numeric code. |
Having trouble getting your view to match your Custom Metric in Klaviyo?
Reach out to us on your dedicated Slack channel or email us at [email protected] and we'd be happy to take a closer look!