Segments
Audience Segments
Segments let you group contacts based on their properties and behavior. Use segments to target the right audience for your flows, filter analytics, and organize your contact base.
Looking for the API? Segments API Reference
How segments work
A segment is a set of filter rules that define which contacts belong to the group. Segments are dynamic — contacts automatically enter or leave a segment as their data changes. When you attach a segment to a flow, only contacts matching the segment's rules will enter the flow.
Segments and environments
Segments are separate per environment. A segment created in test mode evaluates against test contacts, and a segment in live mode evaluates against live contacts. Segments are not shared between environments.
To promote a segment to live, click Clone to Live on the segment detail page (or use the API: POST /v1/segments/{segment_id}/clone). If a segment with the same name already exists in the target environment, it is updated. Otherwise, a new segment is created.
Building a segment
To create a segment, go to the Segments page and click "Create Segment." Add one or more filter rules, then preview the matching contacts before saving.
Each rule has three parts:
- 1.Field — Which contact property to check (email, first_name, custom properties, subscription status, etc.)
- 2.Operator — How to compare (equals, contains, greater than, is set, etc.)
- 3.Value — What to compare against
Multiple rules are combined with AND logic (all rules must match) or OR logic (any rule must match).
Common segment examples
| Segment | Rules |
|---|---|
| Premium users | plan equals "premium" |
| Has email | email is set |
| US-based | country equals "US" |
| Recent signups | created_at is after 30 days ago |