Overview
The Subscribed to List metric appears on a customer’s profile when they are added to your list via a Klaviyo signup form or through Quick Add. It does not always trigger when someone is added to a Klaviyo list via an integration (with some exceptions outlined below). Because of this, it is crucial to understand best practices around using it for triggering flows and creating segments. In this article, you will learn what the Subscribed to List metric entails and when to use it.
Subscribed to List Metric
Subscribed to List is a metric that appears on a customer’s profile when they're added to your list via a Klaviyo signup form, through Quick Add, or with the V2 List API's subscribe endpoint.
Below is an example of what this metric will look like in a profile.
If someone enters their information into a form multiple times, they will not have multiple Subscribed to List metrics found under their profile, nor will they be re-added to the list multiple times.
Klaviyo will only add a Subscribed to List event to a given profile if they are either:
- Not in the list
- In the list, but suppressed
When Subscribed to List Is Added to a Profile
The Subscribed to List metric will only appear when profiles subscribe to a list via a Klaviyo signup form, through Quick Add, or with the V2 List API's subscribe endpoint.
When using the V2 List API, the Subscribed to List event will only fire if the correct endpoint is used. As such, /subscribe is the required endpoint and recommended to collect this metric.
This metric will not populate for profiles that are synced from an integration (with the exception of Mailchimp and some third-party form integrations), added through your API, or uploaded to a list via a CSV file or copy/paste. As a result, there will likely be more profiles in your list than those associated with this specific metric.
For reference, see the chart below:
| The Subscribed to List metric will appear when customers are added via: | The Subscribed to List metric will NOT appear when customers are added via: |
|
|
Several third-party integrations will trigger the Subscribed to List metric, but it is important to make sure that this applies to your integration if you are not using Klaviyo forms. Please consult your integration vendor’s documentation to confirm how they sync data into Klaviyo. You can also check the sync behavior by navigating into a profile added via this integration and seeing if Subscribed to List appears under Metrics.
In general, the following third-party providers' forms should trigger the Subscribed to List metric:
- JustUno
- Privy
- OptinMonster
- GetSiteControl
- BackInStock
- DojoMojo
- ViralSweep
- LeadFamly
- Gleam
- Locksmith
When to Use in a Flow
In general, using the Subscribed to List metric to trigger your flow is not a best practice. Instead, if you want customers in a specific list to go through your flow when added, create a list-triggered flow.
However, if you do use this metric to trigger your flow, be sure to add a trigger filter identifying the specific list you are referring to with the Subscribed to List metric. For example, this trigger filter is: List equals Product Review List.
When to Use in a Segment
Use Subscribed to List when building a segment if you want to view the performance of a specific method for adding subscribers to a list. For example, if you want to see how your newsletter signup form is performing, this metric will show the number of individuals who subscribed to your newsletter through that channel. It will exclude those who you manually upload in the ways previously mentioned.
