Admin Portal: Batch Upload FAQ

Answers to common questions about Batch Upload.

Updated over a week ago

Batch Upload FAQ

Batch Upload is a self-service feature available to administrators with System Access and Enrollment Access to bulk upload enrollment and rostering data. See Batch Upload for more information.

Click here to learn how to bulk edit Class Display Names with Batch Upload.

Can I batch upload data?

Batch Upload is the default method of uploading your data to Amplify if you’re not using a third-party enrollment method. Districts using third-party enrollment will continue to use their third-party enrollment method. Click here to learn about Batch Upload for third-party enrollment sources. If you have System access, you can manually add and edit data through the Admin Portal.

See Batch Upload for more information.

Can I download my data?

You can choose which organization to download your data from and what data you want to download. You can download:

  • All your students and staff

  • All students only

  • All staff only

  • All admins only

If your primary enrollment method is Clever, ClassLink, or GG4L, your data type options are All staff only and All admins only.

Learn how to download your data from Admin Portal: Batch Upload here.

Batch Upload asks for student emails. What if my students don’t have emails?

Amplify Enrollment requires a unique email for all students and staff (this information is used to verify that each account is unique across all districts enrolled with Amplify). The email addresses you provide do not have to be real emails connected to an email inbox. If you are providing fake emails, we recommend that you create an easily recognizable, patterned email structure that you can reliably manage to make sure that the email address tied to each student record is unique.

For example: studentname_IDnumber (at) yourschoolname (dot) org, or

studentname_IDnumber (at) yourdistrict (dot) edu, using standard email format.

Amplify only uses student emails for login purposes (if Amplify Login is activated) and will never send emails to your students.

Email domains with “@amplify” are not accepted for staff and students.

If your district manages rosters directly through the Admin Portal, students do not have to log in with student emails. You can make a request for Amplify to activate Amplify Login, so that teachers can generate usernames and passwords for their students.

I received an error when batch uploading. What happened?

After processing is complete, a report, and, if necessary, an error report, is provided that shows a count of created, updated, no changes, and errors for every school, staff, student, class, and enrollment.

⚠️ If a required or conditional header is missing, misspelled, or improperly capitalized, or if you add column headers not present in this table, the upload will fail. Review the error message, revise the file, and click Select file to upload the revised file.

⚠️ If the file has missing, invalid, or additional data, download the provided error report. The report contains a notation of each error per row of the file along with instructions for how to resolve the error. Correct each error in your file, and upload the file again.

To learn more about the columns, data requirements, and accepted values for each field in this CSV file, you can view the users.csv data dictionary or the demographics.csv data dictionary.

How can I resolve Batch Upload errors?

The following is a list of errors you may encounter during Batch Upload and how to resolve those errors. A row may include multiple errors.

Use Ctrl+F or Cmd+F to search for the error provided in your users-errors.csv file.

ERROR: action must be one of add-update, remove-user, remove-class, unassign

Example data causing this error:

Resolution: Replace with add-update, remove-user, remove-class, or unassign.

ERROR: userGrade must be one of IT, PR, PK, TK, KG, 01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11, 12, 13, PS, UG, Other

Example data causing this error:

Resolution: Student userGrades must be in this format: IT, PR, PK, TK, KG, 01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11, 12, 13, PS, UG, Other. In the CSV file, Grades 1–9 must have a leading "0", such as: "06" and not "6".

If the student has multiple grades, wrap the grades in quotes in the CSV: "05, 06".

Follow these instructions for Microsoft Excel or Google Sheets on how to format columns as Text or Plain Text, so that the leading "0" remains.

ERROR: userGrade must not be present

Example data causing this error:

Resolution: If the row is for a teacher, leave the userGrade field blank. The userGrade only applies to students.

ERROR: classGrade must be one of IT, PR, PK, TK, KG, 01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11, 12, 13, PS, UG, Other

Example data causing this error:

Resolution: classGrades must be in this format: IT, PR, PK, TK, KG, 01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11, 12, 13, PS, UG, Other. In the CSV file, Grades 1–9 must have a leading "0", such as: "05" and not "5".

If the class has multiple grades, wrap the grades in quotes in the CSV: "05, 06".

Follow these instructions for Microsoft Excel or Google Sheets on how to format columns as Text or Plain Text, so that the leading "0" remains.

ERROR: org_sis_id must be an already existing school

Example data causing this error:

Compared to list of schools present in the ORGANIZATIONS list:

Resolution: The school must be present in Admin Portal > Organization list with a matching identifier (district or school ID).

  • The schoolId for Shelfie Elementary in Admin Portal is 303. To resolve, replace 800 in the CSV with 303, or replace 303 in the Admin Portal with 800.

  • The school Dogear ES is not present in Admin Portal yet. The school must be added to the Admin Portal.

    If your district syncs data from Clever, ClassLink, OneRosterCSV Upload, or GG4L, schools must be created in those upstream sources and synced to Amplify.

ERROR: primary_teacher must not be present

Example data causing this error:

Resolution: If the row is for a student, leave the primaryTeacher field blank. The primaryTeacher column only applies to rows for teachers, to indicate that the teacher is the primaryTeacher for the class indicated in these fields: classId**, className**, and classGrade**.

ERROR: primaryTeacher must be one of true, false, 1, 0, yes, no

Example data causing this error:

Resolution: The primaryTeacher field is only required if the fields: classId**, className**, and classGrade** are filled out, to indicate this teacher is a primaryTeacher in the class. If so, the acceptable values are: true, false, 1, 0, yes, or no. If the field is left blank, then it defaults to false.

In this example, the teacher is the primaryTeacher for the classes (not pictured) in Row 2 and not the primaryTeacher in Row 3.

Sort your data by classId to check that values for primaryTeacher are consistent per teacher.

ERROR: className does not match section’s className

Example data causing this error:

Resolution: There is more than one unique value for className indicated for the classId 303S-A1 and the Admin Portal does not know if the desired name is SHIRLEY PERIOD A1 or NEWTON PERIOD B1. There are two ways to resolve this issue, depending on the desired end result:

  • Option 1: If all rows with 303S-A1 are intended to reference SHIRLEY PERIOD A1, replace the className with that matching value.

  • Option 2: If the conflicting row is intended to reference NEWTON PERIOD B1, replace the classId with the unique identifier of that of that class.

Sort your data by classId to check that all className values match the intended classId.

ERROR: classGrade does not match section's classGrade

Example data causing this error:

Resolution: There is more than one unique value for classGrade indicated for the classId 303S-A1. Assign a matching classGrade value for all rows.

Sort your data by classId to check that all classGrade values match the intended classId. Click here for more information related to classGrade errors.

ERROR: userEmail must be a valid email

Example data causing this error:

Resolution: Please provide a valid email address (e.g., studentname@example.com). Common errors include emails with spaces in them (pictured previously) or special characters.

ERROR: Failed to process users for district: [id value], batch: [id value]

Resolution: Check the email address and userId of the student or teacher to confirm they match your district's records. If you do not see an error, please contact your Amplify Customer Care and Support Specialist for further investigation.

ERROR: Failed to process enrollments for district: [id value], batch: [id value]

Resolution: Please contact your Amplify Customer Care and Support Specialist for further investigation.

ERROR: Failed because this user is already associated with multiple IDPs

Resolution: This user's email is associated with multiple authentication methods. Please contact Amplify Customer Care and Support to resolve.

Did this answer your question?