Segments

A segment is a dynamic audience that groups Subscriptions based on filters like activity, country, Tags, and more. Segments help you send personalized, timely, and relevant messages.

Once created, segments update automatically as users interact with your app or site—no extra tracking required.

​

Creating segments

You can create segments in three ways:

• From the Dashboard
• Via the Create Segment API
• By uploading a CSV. See our Import guide for details.

​

Create a segment in the dashboard

1. Go to Audience > Segments
2. Click New Segment
3. Add filters, name the segment, and click Create Segment

​

Exclude segments

Exclude a segment to prevent its members from receiving a message or entering a Journey.

Common use cases:

• Avoid sending duplicate or conflicting messages
• Respect user messaging preferences (e.g., “opted out of promo”)
• Prioritize transactional messages over campaigns

You can exclude segments when:

• Sending a message
• Building a Journey
• Using the Exclude Segment option in segment settings

​

Filters

Filters define which subscriptions belong to a segment. You can combine multiple filters using AND or OR logic.

​

Segment logic: AND vs OR

Use AND to combine filters that all must match. Use OR to match any of multiple conditions.

​

AND filter example

Create a segment of users who:

• Have not returned in more than 7 days
• Will be removed after 11 days (264 hours)

​

OR filter example

Create a segment of:

• Users who subscribed more than 3 days ago
• OR users inactive for exactly 10 days

Name it something like 7 Days Inactive Or Over 3 Days New.

​

Message event filters

Message event filters allow you to filter users based on their interaction with one of your messaging channels within a certain window.

First select the messaging channel you want to filter on, then specify the action that you want to track for that channel and whether the user has or has not performed that action.

You can specify a minimum, maximum, or exact number of time the user must have performed the action in order to qualify, as well as a time window ranging from the last 24 hour to the last 90 days in which they must have performed or not performed the action.

See below for a list of available trackable interactions for each channel:

​

Managing segments

​

View users

Click Options > View Users to see which subscriptions are in the segment.

​

Edit

Click the segment name or Options > Edit to change filters.

​

Pause / Resume

If you’re near your segment limit (based on your plan), you can pause segments. Targeting a paused segment will fail.

​

Set as default

Set a default segment to be auto-selected when sending a new message. This helps reduce targeting mistakes and save time.

​

Duplicate

Copy a segment’s filters to create a new one.

​

Deleting segments

​

In the dashboard

1. Go to Audience > Segments
2. Click the three-dot menu next to a segment
3. Select Delete

​

Using the API

Use the Delete Segment API. Only removes the segment definition.

To delete users in the segment, use the Delete Users API.

{
  "name": "Segment 2",
  "filters": [
    { "field": "session_count", "relation": ">", "value": "1" },
    { "operator": "AND" },
    { "field": "tag", "relation": "!=", "key": "tag_key", "value": "1" },
    { "operator": "OR" },
    { "field": "last_session", "relation": "<", "hours_ago": "30" }
  ]
}

​

FAQ

​

How do I add myself to a segment?

1. Find your Subscriptions using your External ID.
2. Either:

• Set yourself as a Test user
• Add a custom Tag

3. Create a segment using the Test Users filter or the tag.

​

Do segment counts include opted-out users?

• Visible counts only include opted-in subscriptions.
• Segments used in Journeys and in-app messages include both subscribed and unsubscribed subscriptions.
• To see unsubscribed subscriptions, use the Export CSV of Players API.

​

Are segment counts always accurate?

Segments larger than 80,000 total users may have an estimated size, instead of a precise count, in order to calculate them quickly. To get the most accurate numbers, see the message report stats after sending the message.

​

What types of in-app purchases are tracked?

• Tracked: Consumable purchases made while the OneSignal SDK is active.
• Not tracked: Subscription purchases.
• To import historical purchase data, use the Update User API with the purchases parameter.