Skip to content

Segmentation Filters

The Braze SDK provides you with a powerful arsenal of filters to segment and target your users based off of specific features and attributes. You can search or narrow these filters by filter category.

To learn about the different custom attribute data types you can use to segment users, view Custom attribute data types.

Select a category to narrow the glossary:

Ad Tracking Enabled

Allows you to filter based on if your users have opted-in to ad tracking. Ad tracking relates to the IDFA or "identifier for advertisers" assigned to all iOS devices by Apple. This identifier allows advertisers to track users and serve them targeted ads.

Filter Category: Advertising use cases

Age

Segments your users by their age, as they indicated from within your app.

Filter Category: Demographic attributes

Amplitude Cohorts

Clients who use Amplitude can supplement their segments by choosing and importing their cohorts in Amplitude.

Filter Category: Cohort membership

Background Push Enabled

Segments your users on whether they have enabled background push or not.

Filter Category: Channel subscription behavior

Birthday

Segments your users by their birthday, as they indicated from within your app.
Users with a birthday on the 29th of February will be included in segments including March 1.

To target December or January birthdays, only insert filter logic within the 12-month span of the year you're targeting. In other words, do not insert logic that looks back to the previous calendar year's December or forward to the next year's January. For example, to target December birthdays, you can filter for "on December 31", "before December 31", or "after November 30".

Filter Category: Demographic attributes

Braze Segment Extensions

After creating a Segment Extension in the Braze dashboard, you can choose to include/exclude those extensions in your segment.

Filter Category: Segment or CSV membership

Census Cohorts

Clients who use Census can supplement their segments by choosing and importing their cohorts in Census.

Filter Category: Cohort membership

Churn Risk Category

Segments your users by churn risk category according to a specific prediction.

Filter Category: Intelligence and predictive

Churn Risk Score

Segments your users by churn risk score according to a specific prediction.

Filter Category: Intelligence and predictive

City

Segments your users by their last indicated city location.

Filter Category: Demographic attributes

Clicked Alias in Any Campaign or Canvas Step

Filter your users by whether they clicked a specific alias in any campaign or Canvas.

Filter Category: Retargeting

Clicked Alias in Campaign

Filter your users by whether they clicked a specific alias in a specific campaign.

Filter Category: Retargeting

Clicked Alias in Canvas Step

Filter your users by whether they clicked a specific alias in a specific Canvas.

Filter Category: Retargeting

Clicked card

Segments your users by whether or not they have clicked a specific Content Card. This filter is available as a subfilter of "Clicked/opened campaign", "Clicked/opened campaign or Canvas with Tag", and "Clicked/opened step".

Filter Category: Retargeting

Clicked/Opened Campaign

Filter by interaction with a specific campaign.

Filter Category: Retargeting

Clicked/Opened Campaign or Canvas With Tag

Filter by interaction with a specific campaign that has a specific tag.

Filter Category: Retargeting

Clicked/Opened Step

Filter by interaction with a specific Canvas component.

Filter Category: Retargeting

Connected Facebook

Segments your users by whether they connected your app to Facebook.

Filter Category: Social activity

Connected Twitter

Segments your users by whether they connected your app to X (formerly Twitter).

Filter Category: Social activity

Converted From Campaign

Segments your users by whether or not they have converted on a specific campaign. This filter doesn't include users that are in the control group.

Filter Category: Retargeting

Converted From Canvas

Segments your users by whether or not they have converted on a specific Canvas. This filter doesn't include users that are in the control group.

Filter Category: Retargeting

Country

Segments your users by their last indicated country location.

Filter Category: Demographic attributes

Custom Attributes

Determines whether or not a user matches a custom recorded attribute value. (24-hour period)

Time zone:
Company's Time Zone

Filter Category: Custom attributes

Custom Event

Determines whether or not a user has performed a specially recorded event.

Example:
Activity completed with property activty_name.

Time zone:
UTC - Calendar Day = 1 calendar day will look at 24-48 hours of user history

Filter Category: Custom events

Day of Recurring Event

This filter looks at the month and day of custom attribute with the data type of "date", but does not look at the year. This filter is useful for annual events.

Time zone:
This filter adjusts for whatever time zones the user is in.

Filter Category: Custom attributes

Device Carrier

Segments your users by their device carrier.

Filter Category: Devices

Device Count

Segments your users by how many devices they have used your app on.

Filter Category: Devices

Device Google Ad ID

Segments your users by the Google ad ID.

Filter Category: Advertising use cases

Device IDFA

Allows you to designate your campaign recipients by IDFA for testing.

Filter Category: Advertising use cases

Device IDFV

Allows you to designate your campaign recipients by IDFV for testing.

Filter Category: Advertising use cases

Device Model

Segments your users by their mobile phone's model version.

Filter Category: Devices

Device OS

Segments your users that have one or more devices with the specified operating system.

Filter Category: Devices

Device Roku Ad ID

Segments your users by the Roku ad ID.

Filter Category: Advertising use cases

Device Windows Ad ID

Segments your users by the Windows ad ID.

Filter Category: Advertising use cases

Email Address

Allows you to designate your campaign recipients by individual email addresses for testing. This can also be used to send transactional emails to all your users (including unsubscribed) using the "Email Address is not Blank" specifier within the filter.

Filter Category: Other Filters

Email Available

Segments your users by whether or not they have a valid email address, and if they are subscribed/opted-in to email. The email available filter checks for three criteria: if the user is unsubscribed from emails, if Braze has received a hard bounce, and if the email was marked as spam. If any of these criteria are met, or if an email doesn't doesn't exist for a user, the user will not be included.

Filter Category: Channel subscription behavior

Email Opt In Date

Segments your users by the date on which they opted into email.

Filter Category: Channel subscription behavior

Email Subscription Status

Segments your users by their subscription status for email.

Filter Category: Channel subscription behavior

Email Unsubscribed Date

Segments your users by the date on which they unsubscribed from future emails.

Filter Category: Channel subscription behavior

Entered Canvas Variation

Segments your users by whether or not they have entered a variation path of a specific Canvas.

Filter Category: Retargeting

Event Likelihood Category

Segments your users by likelihood of performing an event according to a specific prediction.

Filter Category: Intelligence and predictive

Event Likelihood Score

Segments your users by likelihood of performing an event according to a specific prediction.

Filter Category: Intelligence and predictive

External User ID

Allows you to designate your campaign recipients by individual user IDs for testing.

Filter Category: Other Filters

Feature Flags

The segment of your users that have a particular feature flag currently enabled.

Filter Category: Retargeting

First Did Custom Event

Determines the earliest time that a user has performed a specially recorded event. (24-hour period)

Example:
First Abandoned Cart Less than 1 day ago

Time zone:
Company's Time Zone

Filter Category: Custom events

First Made Purchase

Segments your users by the earliest time that a user made a purchase in your app.

Filter Category: Purchase behavior

First Name

Segments your users by their first name, as they indicated from within your app.

Filter Category: Demographic attributes

First Purchase For App

Segments your users by the earliest time that a user made a purchase from your app.

Filter Category: Purchase behavior

First Used App

Segments your users by the earliest recorded time that they opened your app. Note that this will capture the first session they have using a version of your app with the Braze SDK integrated. (24-hour period)

Time zone:
Company's Time Zone

Filter Category: Sessions

First Used Specific App

Segments your users by the earliest recorded time that they opened any of your apps within your workspace. (24-hour period)

Time zone:
Company's Time Zone

Filter Category: Sessions

Gender

Segments your users by gender, as they indicated from within your app.

Filter Category: Demographic attributes

Hard Bounced

Segment your users by whether or not their email address has hard bounced (such as the email address is invalid).

Filter Category: Retargeting

Has App

Segments by whether or not a user has ever installed your app. This will include users who currently have your app installed and those that have uninstalled in the past. This generally requires users to open the app (start a session) to be included in this filter. However, there are some exceptions, such as if a user was imported into Braze and manually associated with your app.

Filter Category: App

Has Marked You As Spam

Segments your users by whether or not they have marked your messages as spam.

Filter Category: Retargeting

Has Never Received a Message from Campaign or Canvas Step

Segments your users by whether or not they have received any campaign or Canvas component.

Filter Category: Retargeting

Heap Cohorts

Clients who use Heap can supplement their segments by choosing and importing their cohorts in Heap.

Filter Category: Cohort membership

Hightouch Cohorts

Clients who use Hightouch can supplement their segments by choosing and importing their cohorts in Hightouch.

Filter Category: Cohort membership

In Campaign Control Group

Segments your users by whether or not they were in the control group for a specific multivariate campaign.

Filter Category: Retargeting

In Canvas Control Group

Segments your users by whether or not they were in the control group for a specific Canvas.

Filter Category: Retargeting

Install Attribution Ad

Segments your users by the ad that their install was attributed to.

Filter Category: User Attributes

Install Attribution Adgroup

Segments your users by the ad group that their install was attributed to.

Filter Category: Install Attribution

Install Attribution Campaign

Segments your users by the ad campaign that their install was attributed to.

Filter Category: Install Attribution

Install Attribution Source

Segments your users by the source that their install was attributed to.

Filter Category: Install Attribution

Intelligent Channel

Segment your users by their most active channel in the last three months.

Filter Category: Intelligence and predictive

Invalid Phone Number

Segments your users by whether or not their phone number is invalid.

Filter Category: Retargeting

Kubit Cohorts

Clients who use Kubit can supplement their segments by choosing and importing their cohorts in Kubit.

Filter Category: Cohort membership

Language

Segments your users by their preferred language.

Filter Category: Demographic attributes

Last Did Custom Event

Determines the latest time that a user has performed a specially recorded event. (24-hour period)

Example:
Last Abandoned Cart Less than 1 day ago

Time zone:
Company's Time Zone

Filter Category: Custom events

Last Engaged With Message

Segments your users by the last time that they have clicked or opened one of your messaging channels (email, in-app, push). Includes option to filter by machine opens or other opens for email messages. (24-hour period)

Time zone:
Company's Time Zone

Filter Category: Retargeting

Last Enrolled in Any Control Group

Segments your users by the last time that they fell into the control group in a campaign. (24-hour period)

Time zone:
Company's Time Zone

Filter Category: Retargeting

Last In App Message Impression

Segments your users by the last time they viewed an in-app message.

Filter Category: Retargeting

Last Name

Segments your users by their last name, as they indicated from within your app.

Filter Category: Demographic attributes

Last Purchased Product

Filter users by when they first purchased a specific product.

Filter Category: Purchase behavior

Last Received Any Message

Segments your users by determining the last message that was received. (24-hour period)

Example:
Last Received Message Less than 1 Day ago = less than 24 hours ago

Time zone:
Company's Time Zone

Filter Category: Retargeting

Last Received Email

Segments your users by the last time that they have received one of your email messages. (24-hour period)

Time zone:
Company's Time Zone

Filter Category: Retargeting

Last Received Message from Campaign or Canvas With Tag

Segments your users by when they received a specific campaign or Canvas with a specific tag. (24-hour period)

Filter Category: Retargeting

Last Received Message from Specific Campaign

Segments your users by whether or not they have received a specific campaign.

Filter Category: Retargeting

Last Received Message from Specific Canvas Step

Segments your users by when they received a specific Canvas component.

Filter Category: Retargeting

Last Received Push

Segments your users by the last time that they received one of your push notifications. (24-hour period)

Time zone:
Company's Time Zone

Filter Category: Retargeting

Last Received SMS

Segments your users by the last time that they have received an SMS. (24-hour period)

Time zone:
Company's Time Zone

Filter Category: Retargeting

Last Received Webhook

Segments your users by the last time that Braze sent a webhook for that user. (24-hour period)

Time zone:
Company's Time Zone

Filter Category: Retargeting

Last Received WhatsApp

Segments your users by the last time that they have received a WhatsApp message. (24-hour period)

Time zone:
Company's Time Zone

Filter Category: Retargeting

Last Sent Specific SMS Inbound Keyword Category

Segments your users by when they last sent an SMS to a specific subscription group within a specific keyword category.

Filter Category: Retargeting

Last Used App

Segments your users by the most recent time that they have opened your app. (24-hour period)

Time zone:
Company's Time Zone

Filter Category: Sessions

Last Used Specific App

Segments your users by the most recent time that they have opened a specific, designated app. (24-hour period)

Time zone:
Company's Time Zone

Filter Category: Sessions

Last Viewed News Feed

Segments your users by the last time they viewed News Feed.

Filter Category: Retargeting

Location Available

Segments your users by whether or not they have reported their locations. In order to use this filter, your app needs to have location tracking integrated.

Filter Category: Location

Median Session Duration

Segments your users by the median length of their sessions in your app.

Filter Category: Sessions

Mixpanel Cohorts

Clients who use Mixpanel can supplement their segments by choosing and importing their cohorts in Mixpanel.

Filter Category: Cohort membership

Money Spent

Segments your users by the amount of money that they have spent in your app.

Filter Category: Purchase behavior

Most Recent App Version Name

Segments by the recent name of the user's app.

Filter Category: App

Most Recent App Version Number

Segments by the recent app version number of the user's app.

Filter Category: App

Most Recent Device Locale

Segments your users by the locale information from the most recently used device.

Filter Category: Devices

Most Recent Location

Segments your users by the last recorded location at which they have used your app.

Filter Category: Location

Most Recent Watch Model

Segments your users by their most recent smartwatch model.

Filter Category: Devices

Nested Custom Attributes

Attributes that are the properties of custom attributes.

When filtering a nested time custom attribute, you can choose to filter based on "Day of Year" or "Time". "Day of Year" will check only the month and day for comparison. "Time" will compare the full timestamp, including the year.

Filter Category: Custom attributes

News Feed View Count

Segments your users by how many times they viewed News Feed.

Filter Category: Retargeting

Number of Facebook Friends Using App

Segments your users by how many Facebook friends they have who use the same app.

Filter Category: Social activity

Number of Twitter Followers

Segments your users by how many X (formerly Twitter) followers they have.

Filter Category: Social activity

Phone Number

Segments your users by their phone number. Only use digits [0-9]. Do not include parenthesis, dashes, and similar.

Filter Category: Demographic attributes

Provisionally Authorized on iOS

Allows you to find users who are provisionally authorized on iOS 12 for a given app.

Filter Category: Devices

Purchased Product

Segments your users by products purchased in your app.

Filter Category: Purchase behavior

Push Enabled

Segments your users who have provisional push authorization or are enabled for foreground push. Specifically, this count includes:
1. iOS users who are provisionally authorized for push.
2. Users who explicitly activated push notifications for any of the apps in your workspace. For these users, this count includes only foreground push.

Push Enabled does not include users who have unsubscribed.

After segmenting with this filter, you will be able to see a breakdown of who is in that segment for Android, iOS, and web in the bottom panel, called Reachable Users.

Filter Category: Channel subscription behavior

Push Enabled For App

Segments by whether users have push enabled for your app on their device. These users are reachable via push but might not be opted in. This count includes users who have provisionally authorized foreground and background push tokens.

Filter Category: Channel subscription behavior

Push Opt In Date

Segments your users by the date on which they opted into push.

Filter Category: Channel subscription behavior

Push Subscription Status

Segments your users by their subscription status for push.

Filter Category: Channel subscription behavior

Push Unsubscribed Date

Segments your users by the date on which they unsubscribed from future push notifications.

Filter Category: Channel subscription behavior

Random Bucket #

Segments your users by a randomly assigned number (0 to 9999 inclusive). It can enable the creation of uniformly distributed segments of truly random users for A/B and multivariate testing.

Filter Category: Other Filters

Received Campaign Variant

Segments your users by which variant of a multivariate campaign they have received.

Filter Category: Retargeting

Received Message from Campaign

Filter Category: Retargeting

Received Message from Campaign or Canvas with Tag

Segments your users by whether or not they have received a specific campaign or Canvas with a specific tag.

Filter Category: Retargeting

Received Message from Canvas Step

Segments your users by whether or not they have received a specific Canvas component.

Filter Category: Retargeting

Segment Cohorts

Clients who use Segment can supplement their segments by choosing and importing their cohorts in Segment.

Filter Category: Cohort membership

Segment Membership

Allows you to filter based on segment membership anywhere that filters are used (such as segments, campaigns, and others) and target multiple different segments within one campaign.

Note that segments already using this filter cannot be further included/nested into other segments. You must recreate the segment you're trying to include by using the same filters.

Filter Category: Segment or CSV membership

Session Count

Segments your users by the number of sessions they have had in any of your apps within your workspace.

Filter Category: Sessions

Session Count For App

Segments your users by the number of sessions they have had in a specific, designated app.

Filter Category: Sessions

Subscription Group

Segments your users by their subscription group for email or SMS/MMS. Archived Groups will not appear and cannot be used.

Filter Category: Channel subscription behavior

Tinyclues Cohorts

Clients who use Tinyclues can supplement their segments by choosing and importing their cohorts in Tinyclues.

Filter Category: Cohort membership

Total Number of Purchases

Segments your users by how many purchases they have made in your app.

Filter Category: Purchase behavior

Uninstalled

Segments your users by whether they have uninstalled your app and have not reinstalled it.

Filter Category: Uninstall

Updated/Imported from CSV

Segments your users based on whether they were a part of a CSV upload or not.

Filter Category: Segment or CSV membership

Web Browser

Segments your users by the web browser they use to access your website.

Filter Category: Devices

X Custom Event In Y Days

Determines whether or not a user has performed a specially recorded event between 0 and 50 times in the last specified number of calendar days between 1 and 30. (Calendar Day = 1 calendar day will look at 24-48 hours of user history)
Learn more about X-in-Y behavior here.

Example:
Abandoned Cart exactly 0 times in the last 1 calendar day

Time zone:
UTC - To account for all time zones, 1 calendar day will look at 24-48 hours of user history, depending on the time the segment is evaluated; for 2 calendar days, will look at 48-72 hours of user history, and so on.

Filter Category: Custom events

X Custom Event Property In Y Days

Determines whether or not a user has performed a specially recorded event in relation to a specific property between 0 and 50 times in the last specified number of calendar days between 1 and 30. (Calendar Day = 1 calendar day will look at 24-48 hours of user history)
Learn more about X-in-Y behavior here.

Example:
Added to Favorites w/ property "event_name" exactly 0 times in the last 1 calendar day

Time zone:
UTC - To account for all time zones, 1 calendar day will look at 24-48 hours of user history, depending on the time the segment is evaluated; for 2 calendar days, will look at 48-72 hours of user history, and so on.

Filter Category: Custom events

X Money Spent in Y Days

Segments your users by the amount of money that they have spent in your app in the last specified number of calendar days between 1 and 30. This amount will only include the sum of the last 50 purchases.
Learn more about X-in-Y behavior here.

Filter Category: Purchase behavior

X Product Purchased In Y Days

Filter users by times a specific product was purchased.

Filter Category: Purchase behavior

X Purchase Property In Y Days

Segments your users by the number of times a purchase was made in relation to a certain purchase property in the last specified number of calendar days between 1 and 30.
Learn more about X-in-Y behavior here.

Filter Category: Purchase behavior

X Purchases in Last Y Days

Segments your users by the number of times (between 0 and 50) they have made a purchase in the last specified number of calendar days between 1 and 30.
Learn more about X-in-Y behavior here.

Filter Category: Purchase behavior

X Sessions In Last Y Days

Segments your users by the number of sessions (between 0 and 50) they have had in your app in the last specified number of calendar days between 1 and 30.
Learn more about X-in-Y behavior here.

Filter Category: Sessions
HOW HELPFUL WAS THIS PAGE?
New Stuff!