Mental model
Membership is dynamic. When customer data changes, the same rules can match a different set of people the next time you open or run the cohort.
An audience with no filter rules matches all customers in the workspace until you add rules.
Create a cohort
1
Open Cohorts
Go to
Customers > Cohorts and select Create Cohort.2
Name the cohort
In New cohort:
- Name — for example
US Enterprise - Description — for example
High-value customers in North America
3
Open the cohort
From the list, open the cohort row to reach its detail page.
Cohorts may be gated by a workspace feature flag (
isCohortsEnabled). If Cohorts is missing under Customers, ask a workspace admin or Oration support to enable it.Define the audience
On the cohort detail page, build and save rules in the Audience card.Filter fields
Same advanced filters as the Customers page:
Combine, reorder, or clear rules as needed. Incomplete rules show Filter is incomplete until every rule is valid.
Preview and save
- Add or edit filter rules in Audience.
- Select Run to preview matching customers without saving.
- Select Save to store the audience on the cohort.
Run refreshes the preview only. Save persists the audience.
Edit or delete
From the list or detail page, open More options (⋯):- Edit — change Name and Description, then Save Changes.
- Delete — type the cohort name to confirm. Deletion cannot be undone.
Permissions
If Create Cohort, Save, Edit, or Delete is missing, ask a workspace admin for cohort permissions. Preview also requires permission to list filtered customers.
Customers and campaigns
- Customers — upload or sync people first (Uploading Customers). Cohorts only filter customers that already exist.
- Campaigns — manage cohorts under
Customers > Cohorts. Campaign targeting still follows Managing Campaigns, including SQL-based targeting where configured. Do not assume a one-click cohort picker on the campaign form.
Practical notes
- Start with one or two metadata or source rules, Run, then tighten.
- Prefer descriptive names (
Enterprise · US · DND off) so teammates can find the right cohort. - After large CSV uploads, reopen the cohort and Run to confirm membership.
- Account for DND and consent before outbound work that uses a segment.
FAQ
Does an empty audience mean no customers?No. With no filter rules, the audience matches all customers in the workspace. Does editing the name change who is included?
No. Only the Audience filters control membership. Can I attach a cohort to a campaign from the UI?
Not in the current release. Use the campaign targeting flow in Managing Campaigns.
Limitations
- Managed in the Agents Platform UI only. No public Cohorts REST API in this release.
- Audience rules are customer filters — not ticket or conversation filters.
- The Cohorts nav item can stay hidden until
isCohortsEnabledis on. - In-app copy may mention attaching cohorts to campaigns; that wiring is not available yet. Confirm the live campaign flow before planning around a cohort selector.
Questions: support@oration.ai or developers@oration.ai.