Adding ID Lists

Adding ID lists

What is an ID list?

An ID List lets you define a reusable audience segment using user identifiers like userID, stableID, or organizationID.

You can manage ID Lists by manually adding or removing IDs, uploading CSVs, or replacing the entire list.

Creating an ID list segment

1. Navigate to the Segments section in the Statsig Console.
2. Click Create New Segment.
3. Toggle the segment type from Conditional to ID List.

   

4. Select the ID type you want to build from.

   

Managing IDs

After you open your ID List segment, you have several options:

• Manual Entry: Enter IDs directly into the input box.

  

• Upload CSV: Import a list of IDs from a CSV.
• Bulk Actions: Choose how your input affects the existing list:
  • Add: Add IDs to the list
  • Remove: Remove matching IDs from the list
  • Replace: Clear all IDs and replace with a new list

There's a hard limit of 10 million IDs across all ID Lists in your project.

Keep ID lists small

Statsig synchronizes ID Lists with fewer than 1,000 IDs in the same process as feature gates, experiments, and conditional segments, providing high consistency and reliability. ID Lists over 1,000 IDs use a separate synchronization process for scalability. As a result, Statsig doesn't include them in the main initialization path (for server SDKs or the local evaluation version of client SDKs), and change propagation takes longer.

Keep each ID List to no more than 1,000 IDs unless the longer propagation time is acceptable.

Large ID lists

To target hundreds of thousands or millions of users, the more performant approach is to set an attribute on the User object passed to the Statsig SDK. For example, pass user_type:Paid or user_type:Trial in the User object instead of maintaining large ID Lists. This approach requires your app to have the attribute available when calling the Statsig SDK. If your use case requires ID lists larger than 10,000 IDs, contact the Statsig team through Slack.