Analytics & Insights
English Spanish

Manage groups

The updated group management experience has two separate areas:

  • Groups, which contain students.

  • User Groups, which contain staff or application users.

You can create groups by searching for records, entering identifiers, or uploading a CSV file. You can also share student groups with users and user groups and give them access permissions.

Manage student groups

Find a student group

  1. Go to Manage Groups.

  2. Select Student Groups.

  3. Use the filters to narrow the list.

  4. To find a specific group, enter its name in the search field.

  5. Select the group to view or manage it.

The options you see on the Student Groups page depend on your permissions.

Create a student group

  1. Go to Manage Groups and select Student Groups.

  2. Select Create Group.

  3. Enter the group details.

  4. Select Save and Continue.

The new group has no members yet. Add students by searching, by entering student IDs, or by uploading a CSV file.

Add students by searching

  1. Create a student group or open an existing one.

  2. Select [Search Students].

  3. Enter the student information in the search fields.

  4. Select the students you want to add.

  5. To review only the students you've selected, select Show selected.

  6. Select Save.

Add students by entering student IDs

  1. Create a student group or open an existing one.

  2. Select [Enter Student IDs].

  3. Paste or enter the student IDs.

  4. Select Validate.

  5. Review the matched and unmatched records.

  6. Correct any unmatched IDs and select Validate again.

  7. Review the selected students.

  8. Select Save.

Valid IDs are selected automatically. Unmatched IDs stay in the list so you can correct them. Your selections are kept when you switch between methods for adding students, but they aren't applied to the group until you select Save.

Upload students to a student group

Prepare the CSV file

Download the CSV template from the upload page. The student template has a single Student ID column.

Before you upload, make sure that:

  • The file is in CSV format.

  • The file has no more than 100,000 records.

  • The file is no larger than 50 MB.

  • Each row contains a valid student ID.

Duplicate student IDs are removed during validation.

Upload a student list

  1. Create a student group or open an existing one.

  2. Select Student Upload.

  3. If needed, select Download template, enter the student IDs, and save the file in CSV format.

  4. Drag the file to the upload area, or select the upload area and browse to the file.

  5. Select Validate.

  6. Review the validation summary and the matched students.

  7. If there are unmatched records, resolve them. See Resolve unmatched student records.

  8. Select an apply option.

  9. Select Save.

You can upload only one file at a time. If you select another file, it replaces the one currently selected.

Choose how the upload affects the group

When you upload students to an existing group, select one of these options. These options only appear when the group already has members.

Option

Result

Replace current [group type]

Replaces the group's current members with the validated students in the file.

Add to current [group type]

Keeps the current members and adds the new, validated students from the file. Students who are already members are ignored.

The Replace current students option is selected by default. Check your choice before you Save. These options apply only to CSV uploads.

Resolve unmatched student records

After validation, the page shows the number of matched, unmatched, and duplicate records.

  1. Select [Download unmatched records].

  2. Open the downloaded file and review the incorrect or unrecognized student IDs.

  3. Correct the source CSV file.

  4. Upload the corrected file and select Validate again.

  5. Confirm that the corrected students appear in the matched list.

  6. Select Save.

Duplicate IDs are counted only once and are removed from the validated selection.

Delete a student group

You can delete a student group if you own it or have Collaborative permission.

  1. Go to Manage Groups and select Student Groups.

  2. Find the group.

  3. Select Delete.

  4. Confirm the deletion.

Share a student group

Sharing lets other users or user groups access a student group.

Share with a user group

  1. Go to Manage Groups and select Student Groups.

  2. Find the group and select Share.

  3. Search for the user group.

  4. Select a permission for the group.

  5. Repeat steps 3 and 4 for any other user groups.

  6. Select Save.

The sharing page shows how many user groups you've selected. Use the filters to show groups you created or groups that already have access.

Share with an individual user

  1. Open the sharing settings for the student group.

  2. Go to [Individual Users].

  3. Search for the user.

  4. Assign a permission.

  5. Repeat steps 3 and 4 for any other users.

  6. Select Save.

To remove a user's access, go back to the sharing settings and change or remove their permission.

Sharing permissions

Permission

Access

Read only

Can view the group but can't edit or delete it. [Confirm: can still use the group to filter dashboards.]

Edit

Can edit details and members, but cannot delete the group or switch it between private and public.

Collaborative

Can edit the group and its members and can delete the group.

The actions available to a user depend on the permission assigned to them or their user group.

Create a user group while sharing

If the user group you need doesn't exist, you can create it without leaving the sharing workflow.

  1. Open the sharing settings for the student group.

  2. Select [Create User Group].

  3. Enter the user group name.

  4. Add users by searching for them or uploading a user list.

    1. Prepare the CSV file

      Download the CSV template from the upload page. The user template has two columns: District code and Username.

      Before you upload, make sure that:

      • The file is a .csv file. Other file types aren't accepted.

      • The file has no more than 1,000 records.

      • The file is no larger than 50 MB.

  5. Select Save to create the user group.

  6. Assign a sharing permission to the new group.

  7. Select Save again to apply the sharing settings.

Manage user groups

User groups let you organize staff or application users so you can share student groups with them.

View user groups

  1. Go to Manage Groups and select User Groups.

  2. Search for a group or use the filters.

  3. Select a group to view its details.

For each group, the list shows:

  • The number of users

  • The number of associated student groups

  • When it was last modified

  • Edit and delete actions, depending on your permission

Create a user group by searching for users

  1. Go to Manage Groups and select User Groups.

  2. Select Create Group.

  3. Enter the user group name.

  4. Select [Search Users].

  5. Search for and select the users you want to add.

  6. Review the selected users.

  7. Select Save.

Create a user group by uploading users

  1. Go to Manage Groups and select User Groups.

  2. Select Create Group and enter the user group name.

  3. Select Upload User List.

  4. Download the CSV template.

  5. Format the identifier columns as text, then add the user information.

  6. Save the file in CSV format.

  7. Drag the file to the upload area, or browse to the file and select it.

  8. Select Validate.

  9. Review the matched and unmatched users. If needed, correct the unmatched records and upload the file again.

  10. Select an apply option.

  11. Select Save.

User CSV requirements

The user CSV template includes the identifiers used to match users:

  • District code

  • Username

The file is validated against existing user records, so make sure the district code and username are correct.

Important: In Microsoft Excel, format the identifier columns as Text before you enter or paste values. Otherwise, Excel may convert long identifiers to scientific notation (for example, 3.526E+19), and those values won't match during validation.

Update a user group with a CSV file

  1. Open the user group.

  2. Select [Upload User List].

  3. Upload and validate the CSV file.

  4. Select an option:

    • Replace replaces all current members with the users in the file.

    • Add keeps the current members and adds the new users from the file.

  5. Review the matched users.

  6. Select Save.

Add never removes existing members.

Remove a user from a user group

To remove one or a few users, update the members manually rather than uploading a replacement file.

  1. Open the user group.

  2. Show the selected users.

  3. Search for the user you want to remove.

  4. Clear the user's selection.

  5. Select Save.

Note: Uploading a CSV file with Replace replaces all of the group's members. Do not use it to remove just one user.

Delete a user group

You can delete a user group if you own it or have Collaborative permission.

Deleting a user group removes any sharing that depends on it.

  1. Go to Manage Groups and select User Groups.

  2. Find the group.

  3. Select Delete.

  4. Confirm the deletion.

Users with Edit permission can change the group but cannot delete it. Users with Read only permission can only view it.