Assign User Fields to a Cohort
Automatically fill a Cohort with users who match User Field conditions.
To automatically assign users to a Cohort, use User Field conditions. Any user whose profile matches the conditions is added to the Cohort, and membership stays up to date as profiles change. For the manual method, see Manually Adding Users to a Cohort. For an overview, see What is a Cohort?
What do you need before you start?
- Admin access.
- The custom user fields you want to use. Create them first under Tenancy Management, or they will not appear in the field dropdown.
- Assign All Users turned off on the Cohort. Conditions cannot be added while it is on.
How do you assign User Fields to a Cohort?
- Navigate to Admin > User Management > Manage Cohorts.
- Click the actions icon on the Cohort, then select Assign User Fields.
- Click Add Field Condition.
- Select a field from the dropdown menu.
- Set the operator (e.g. equals or contains) and enter the value.
- Click Update Field Conditions to save.
Note: if the Cohort currently uses Assign All Users, turning it off empties the Cohort until the new conditions are calculated. Workflows and Courses restricted to that Cohort will not apply to anyone during that short gap. Make the change outside busy periods.
How does the Users Must Match setting work?
The match setting controls how multiple conditions are combined:
- All - only users who meet every condition are added.
- Any - users who meet at least one condition are added.
What should you watch for with "contains"?
Contains matches any value that includes your text. For example, "contains Athletics" also matches "Little Athletics". Multi-select fields do not offer Equals, so you cannot exclude these partial matches with a single condition. Use a more specific value, or a separate field.
How do you target a combination, such as one department in one group?
Each condition holds one value. To target Compliance staff in two different groups, create two Cohorts, each with All selected:
- Cohort "Compliance - Group A": Department equals Compliance, and Group equals A.
- Cohort "Compliance - Group B": Department equals Compliance, and Group equals B.
Then enroll both Cohorts into the Course. This is also the workaround for the enrollment screen, which only filters by one Cohort at a time.
How do you see who is in the Cohort?
Click the eye icon on the Cohort.
How do you remove User Field conditions?
- Click the actions icon on the Cohort, then select Assign User Fields.
- Find the condition you want to remove.
- Click the bin icon next to it.
- Click Update Field Conditions to save.