Segment Builder

Create segments with the visual condition editor

Segment Builder

Build segments visually by combining conditions with AND/OR logic. Filter by user properties, event history, segment membership, subscription state, and feature access.

Opening the builder

To create a new segment:

Go to Segments in the dashboard sidebar.
Click Create Segment.
Give your segment a name and optional description.
Add conditions using the builder.

To edit an existing segment, open it from the segment list and go to the Overview tab.

Condition groups

The builder organizes conditions into groups. Each group contains one or more conditions combined with a logic operator.

Within a group -- Conditions are combined with AND or OR.
Across groups -- Groups are combined with AND or OR.

For example, you might create a segment for "users on the free plan AND (completed onboarding OR used the app at least 3 times)." This uses two groups: one with a customer property condition, and one with two event conditions joined by OR.

Adding groups

Click Add condition group to create a new group. Each group is labeled (A, B, C, and so on). You can delete or duplicate groups as needed.

Setting logic operators

When a group has more than one condition, a logic selector appears:

AND -- All conditions in the group must be true.
OR -- At least one condition in the group must be true.

When multiple groups exist, an outer logic selector controls how groups combine.

Filter types

Each condition row starts with a type selector. Choose the kind of data you want to filter on:

Filter type	What it checks	Example
Customer property	A value on the user's profile	`plan` equals `free`
Event	Whether an event occurred, how many times, or when	User performed `purchase` in last 30 days
Segment membership	Whether the user belongs to another segment	User is in "Completed Onboarding"
Subscription	The user's subscription state	Subscription is active or trialing
Feature access	Whether the user has access to a feature	User has access to "premium_export"

Customer property conditions

Filter by any property stored on the user's profile. Select a property key from the picker, choose an operator, and enter a value.

Available operators depend on the property type:

String: equals, does not equal, contains, does not contain, is set, is not set
Number: equals, does not equal, greater than, less than, is set, is not set
Boolean: is true, is false

Event conditions

Filter by the user's event history. Select an event name, then choose a behavior type:

Performed -- The user fired the event at least once (with optional count and time window).
Not performed -- The user has not fired the event (within an optional time window).
Sequence -- The user performed event A followed by event B.

You can add property filters to narrow the event match. For example, "performed purchase where amount > 50 in the last 7 days."

Segment membership conditions

Reference another segment. This lets you compose complex audiences from simpler building blocks.

Is in segment -- The user is currently a member of the referenced segment.
Is not in segment -- The user is not a member.

When you reference another segment, Nuxie tracks the dependency and ensures the referenced segment is evaluated first. See Using Segments for details.

Warning: You cannot create circular references. If Segment A references Segment B, then Segment B cannot reference Segment A. The builder prevents you from selecting segments that would create a cycle.

Subscription conditions

Filter by the user's subscription state. Available operators include:

Is active, trialing, expired, cancelled, or grace period

Feature and credit conditions

Filter by feature access or credit balance:

Feature access -- Whether the user has access to a specific feature.
Credits -- Compare the user's credit balance for a feature (equals, greater than, less than).

Property and event pickers

When selecting property keys, event names, or features, the builder shows a searchable picker populated with values from your app. The picker uses your app's event and property taxonomy, so you see real data from your users.

Type to search across all available values. The picker shows the most common matches first.

Saving a segment

After configuring conditions, click Save to persist the segment. Nuxie compiles your conditions into an optimized rule set, syncs the segment definition from the server, and begins evaluating users.

The Customers tab shows matching users as evaluation completes. Member counts update as new events are processed.

Next steps

Using Segments -- Reference your segments in campaigns and experiments.
Segments Overview -- Review how segments fit into the Nuxie platform.