Skip to content

Importing Students Via CSV

When you have a lot of students to put into groups, Bulk Import does it from a CSV in one go. It works with students who are already assigned to you in the Program you pick: the file lists those students and the group each one goes in.

Bulk Import doesn’t add new students or assign anyone to you. Your Braintrust team handles that - see How Students Get Assigned to Me.

Before You Start

  • You need to be assigned to at least one school and one Program.
  • The students in your file need to already be assigned to you in that Program.
  • Download the sample CSV from inside the import form and build your file from it. The sample is the reference for which columns are required, and it’s kept current there rather than here.

How to Import

  1. Open My Students. Click Students in the left navigation.

  2. Click Bulk Import. It sits at the top of the roster. The form that opens is titled Bulk Import Student Groups.

  3. Choose a Program. The form asks you to select a Program to associate with the groups you’re uploading. You can’t upload until you’ve picked one.

  4. Download the sample CSV. The form links to it. Match your file to its columns.

  5. Click Upload & Import and pick your file. The upload starts as soon as you choose the file, so there’s no separate submit step.

What Happens After You Import

A results screen titled Bulk Import Results tells you what landed. At the top it counts how many users were created, and adds counts for modified or unaltered users when there are any. Below that, a table lists each user by Email and Type. Hover a row’s icon to see whether that person was Created, Modified, or Unaltered.

Students in the file are placed in the groups it names. A row is skipped, and listed as a warning, if the student isn’t already one of your students in that Program or if the Program is full. See Reading the My Students Table to check the result.

Common Issues

The Import Failed

If something’s wrong, the form stays open and lists the problems rather than importing a partial roster. Problems come in two kinds: ones about the file as a whole, and ones about a specific record. Fix what it names and upload again.

It Imported but Flagged Warnings

Warnings mean rows that went in with something worth a second look. The header tells you how many there were, individual rows carry a warning icon you can hover, and anything that doesn’t belong to a row appears under Additional Warnings below the table. Read them before assuming the roster is complete.