Platform access level: Org Admins and Managers.
Use Learners to find a learner, update their details, and manage their course enrollments. You can also add learners, organize them into cohorts, and use bulk actions to update a selection.
Learners receive content; teammates run Arist. To invite someone to work in Arist, see Managing Users and Roles.
1. Finding a learner
Select Learners in the sidebar under People.
The All learners tab shows each learner’s Name, Cohorts, and Platforms.
Search by name or select + Filter to filter by delivery method or cohort, or use the Person fields and Metadata fields groups. Select a learner to open their Profile.
The list follows the team selected at the top of the sidebar, including for Org Admins. Select the Default team to see every learner in the organization. See Managing Team Settings for how Default team membership works.
Try it: Search for your own name and open your profile.
Saving a view
Save rules and filters as a named view to reuse them later. Saved views belong to you.
With no saved view applied, set at least one rule or filter. Setting a delivery method or cohort filter changes the + Filter button to +.
Select Save as view beside Clear all.
Enter a View name, then select Save. Saving with an existing view's name replaces that view's rules.
After you save a view, use Saved views to apply it again. If you change its rules or filters and keep at least one rule or filter set, select Update saved view to save those changes.
Select Delete view, then Delete in the confirmation to remove a saved view. Deleting a view does not change any learner. Select Clear all to clear the current rules and filters.
Downloading the learner list
Select Download to export the learners matching your search and filters as a CSV. The file includes profile fields, cohorts, and metadata.
Reviewing activity
Org Admins can select Activity to review recorded learner and cohort changes across the organization. Use Date to filter the history.
Note: The feed shows recorded actions. Earlier changes may not appear.
For activity within a team, see Managing Team Settings.
Select Cohorts to create and manage learner groups. See Managing Cohorts for the complete process.
2. Reviewing a learner’s profile
Select a learner to open their Profile.
Use the profile sections to check:
Account details: The learner’s name, account email, timezone, language, delivery preference, and external user ID.
Delivery addresses: The learner’s stored delivery addresses, including addresses for delivery methods your organization has turned off.
Cohorts enrolled in: The groups that include the learner.
Enrollments: Their current and previous course enrollments.
Understanding where learner details come from
Learner profiles can be created manually, uploaded from a file, or created and updated through an integration. The details supplied by an HR or directory integration depend on your organization’s setup.
Microsoft Teams and Slack integrations supply the delivery addresses used to identify learners in those apps. These are separate from an Email delivery address, even when the displayed email is the same. Teams and Slack addresses cannot be edited on the learner’s profile.
If an integration supplies information that needs correcting, confirm with the person managing that integration where the change should be made.
Reading delivery-address indicators
On an individual learner’s Profile, look under Delivery addresses for the indicators beside each address. They describe its default status, connection record, or delivery availability. They do not confirm that a particular message reached the learner.
Indicator | What it means |
Check icon | This is the learner’s default address for that delivery method. For example, Default Email address identifies their default email address. The icon appears for SMS, WhatsApp, and Email. |
Connected | Arist has recorded a connection with this learner in Microsoft Teams or Slack. This does not guarantee that the app is currently reachable or that a message arrived. |
Not connected | Arist has no recorded connection with this learner in Microsoft Teams or Slack yet. The stored address is not necessarily incorrect. |
Inactive | Your organization has turned off that delivery method, or has no connected Teams or Slack integration for it. The stored address is retained. |
Opted out | The learner opted out of a sender used by one of their enrollments. This does not mean the address is invalid or that they opted out of every Arist sender. |
Email, SMS, and WhatsApp addresses do not show Connected or Not connected badges. A default checkmark can appear beside Inactive or Opted out.
For Microsoft Teams and Slack, the displayed email alone does not establish the integration connection. If the learner has installed or opened the Arist app but still shows Not connected, ask an Org Admin to check the integration under Settings, in Delivery methods. Contact Arist Support if it remains unresolved.
For an individual delivery investigation, start with Helping Learners Resolve Content Delivery Problems.
Reviewing the learner’s activity
Scroll to Activity to review recorded imports, metadata updates, team membership changes, and other events involving the learner. Filter by date or event type.
The history can include events from before the learner joined your team.
Note: Older activity may be incomplete.
3. Updating learner details
Org Admins and Managers can select Edit on the learner’s Profile to update account details, delivery addresses, metadata, and team membership.
Updating a delivery address
In the learner’s edit panel, you can correct an SMS, WhatsApp, or Email address when its Edit control is available:
Select Edit on the address row.
Correct the address.
Select Save address.
Existing enrollments using that address record follow the corrected value. Correcting an SMS or WhatsApp number does not clear its existing sender opt-outs.
Important: Removing a delivery address does not stop existing enrollments from sending to it. To stop delivery, cancel the affected enrollment. Changing the default address also does not redirect an existing enrollment.
Microsoft Teams and Slack addresses come from their integrations and cannot be edited here. Contact Arist Support if an integration address identifies the wrong person, or an address change you need is unavailable.
Changing a learner’s preferred language
Select Edit, change Language, then select Save.
If Update enrollments too? appears:
Select Update enrollments to change compatible current enrollments from their next message.
Select Keep current languages to change only the profile preference.
For how Arist chooses between an enrollment’s language, the learner’s preference, and the course default, see Managing Course Languages.
Changing team membership
Use Teams in the edit panel to change the learner’s membership.
To move the learner, deselect the current team, select the destination, and select Save.
The field lists the teams you can manage. The Default team is not selectable because it provides organization-wide visibility.
Removing a team here also keeps that team’s rules from adding the learner again. For team rules and restoring excluded learners, see Managing Team Settings.
Metadata can be used by team rules, cohort rules, and automations. For defining metadata fields, see Managing Metadata Fields. For automated actions, see Setting Up Automations.
4. Managing course enrollments
Open Enrollments on the learner’s profile to review current, completed, and cancelled enrollments.
Review the course, delivery address, dates, and status. Hover over the status for its explanation. For an Error, use Helping Learners Resolve Content Delivery Problems to investigate. See Understanding Enrollment Statuses for other status guidance.
If your organization uses Arist Messenger, Last platform shows where the learner last interacted with that enrollment: Web, Mobile, or Microsoft Teams.
Enrollment actions follow the team you are currently viewing, including for Org Admins. If an action fails because the learner belongs to another team, switch to one of their teams or the Default team.
Select Enroll to add the learner to another course. For the delivery process, see Scheduling and Delivering Courses.
Managing an existing enrollment
Open the enrollment’s row menu.
Available actions depend on the enrollment’s current status and can include:
Start, Pause, or Resume.
Prioritize, Resend, Rewind, or Re-enroll.
Change language or Revoke link.
Send opt-out notification, Cancel, Complete, or Close.
Selecting Change language affects only that enrollment and takes effect from its next message.
Learners can change their own enrollment language when your organization permits learner-managed enrollments. For that setting, see Managing Organization Settings.
Revoking an enrollment link
If an enrollment link reaches the wrong person, you can replace it.
Open the enrollment’s row menu and select Revoke link.
Review the confirmation, then confirm the change. Arist replaces the link without notifying the learner. Select Resend to send the replacement.
Important: Revoking a link cannot be undone.
5. Checking delivery for one enrollment
Each enrollment has its own assigned delivery address. Changing a default address does not move an existing enrollment to another address.
Open the learner’s Enrollments.
Find the affected enrollment and read its Address column.
Find the same address under Delivery addresses to check its indicators.
Open the enrollment’s row menu and select Manage.
If the address is no longer listed under Delivery addresses, continue to Manage to review the enrollment’s messages. An existing enrollment can still use a removed address even though it no longer appears on the profile.
Review the delivery method, delivery time, timezone, and course progress. Compare the message log with what the learner reports receiving.
Select Resend last message when the learner needs the latest message again. For the complete investigation route, see Helping Learners Resolve Content Delivery Problems.
6. Adding learners
Your organization may already create learner profiles through an integration. Check for an existing profile before adding someone manually or uploading a file.
Org Admins and Managers can select Add learners to enter one learner manually or upload a file.
Choose Team and Also add to cohort when needed. The Default team is not a team option. Leaving Team empty adds learners to the organization without assigning another team.
Adding one learner manually
Select Enter manually, choose the team and cohort when needed, then select Continue.
Enter Account email first.
If the email is new, complete the learner’s details and delivery address, then select Add learner.
If it belongs to an existing learner or another user in the organization, Arist uses that record instead of creating a duplicate.
If the delivery address belongs to someone else, open that person’s record to update it.
When account emails are optional for your organization, select Continue without an email to add a learner without one.
Uploading a learner file
Select Upload CSV, choose the team and cohort when needed, then select Continue.
Upload a CSV or Excel file up to 50 MB. You can download a template containing the expected columns.
Confirm whether the first row contains column names.
Map each column to a learner field or existing metadata field. An Org Admin can also create a new metadata field from the column mapper. Unmapped columns are ignored.
Review the import results and correct any failed rows.
Select Finish.
Arist matches learners by account email first and then by delivery address. Matching rows update the existing learner. Imported names, timezone, and language replace existing values, while new delivery addresses are added.
A delivery address already assigned to someone else causes that row to fail. Some rows can succeed while others report errors.
Successfully imported learners remain selected when you are viewing the Default team or the team they were added to. Otherwise, the list reloads without selecting them.
Your organization may allow existing learners to be matched by account email without a delivery-address column. For import requirements and that setting, see Managing Organization Settings.
7. Using bulk actions
Select the checkbox beside one or more learners to open the selection bar.
Select Select all … learners across all pages to include every learner matching the current search and filters.
Moving between pages preserves your selection. Changing the search, filters, or sort order clears it.
Important: Remove from team keeps the learners in Arist and excludes them from rejoining that team through its rules. Delete removes them from your organization. Review the confirmation carefully before continuing.
From the selection bar:
Select Bulk edit to update metadata.
Select Add to cohort to add learners to an existing cohort.
Open the three-dot menu to Create cohort or Delete learners.
From the Default team, Org Admins can select Create team to create a team from the selection.
From another team, select Remove from team to remove learners from that team.
For restoring excluded learners, see Managing Team Settings.
Deleting more than 50 learners runs in the background and displays its progress and any failures.
Creating a cohort from the Learners page
You can create a cohort directly from the learners you select.
Open Learners in the sidebar and select the All learners tab.
Use search or filters to find the learners you want.
Select the checkbox beside each learner. To include every matching learner across pages, select Select all … learners across all pages on the selection bar.
Open the three-dot menu on the bar and select Create cohort.
Enter a Name that isn’t already used by another cohort in your organization.
Optionally choose a Preferred timezone.
Select Create cohort to confirm.
Your new cohort contains the selected learners. Open the Cohorts tab to find and manage it.
If you’ve just uploaded learners, successfully imported learners remain selected when you finish the import, so you can start at step 4. This applies when you’re working in the Default team or imported the learners into the team you’re currently viewing.
For timezone behavior and ongoing cohort management, see Managing Cohorts.
8. Editing metadata in bulk
Select learners, then select Bulk edit to change metadata for up to 1,000 learners.
Important: Changing metadata used by a team or cohort rule can move learners into or out of that group. Review its rules first. See Managing Cohorts.
For each field, choose:
Leave unchanged: Preserve the current values.
Set to…: Give every selected learner the same value.
Clear: Remove the value from every selected learner.
Arist summarizes existing values as All match, No values, Mixed, or a count such as 3 values.
Select Save after setting or clearing at least one field.
A selection across all pages includes every learner matching the current search and filters. For larger groups, filter the list and edit up to 1,000 learners at a time.
Related articles
Note: Need help at any point? Reach out to your Arist Customer Success contact, or email [email protected].





















