The Import Grades feature allows you to upload multiple student grades at once into a course gradebook using a CSV file. This is useful for saving time and managing large classes.
How to import grades
Open the course and go to the Gradebook page
Click the Import grades button (cloud upload icon)
Upload your CSV file in the import dialog
The system will validate and process your file
You’ll see either a success message or detailed error feedback
CSV format
Your file must follow this structure:
Column | Required | Description |
student_id | Yes | The student’s system ID (Teach ’n Go ID) |
gradebook_name | If multiple gradebooks exist | Must match an existing gradebook in the course |
grade_name | No | Grade type (e.g. “Assignment 1”, “Quiz 2”) — must match an existing grade type |
grade_value | Required if grade_name is set | Numeric (0–100) for percentage grades, or a valid dropdown value |
class_grade | No | Overall class grade for the student |
notes | No | Notes for the student’s grade record |
Important:
Each row must include at least one of the following:
grade_name + grade_value
class_grade
notes
Validation rules
Before importing, the system checks your data:
student_id must belong to a student in the course
gradebook_name must match an existing gradebook (case-insensitive)
grade_name must match an existing grade type
grade_value must be valid:
0–100 for percentage grades
Matching option for dropdown grades
If there are errors, you’ll get row-by-row feedback so you can fix and re-upload your file.
After import
Once your file is successfully processed:
Grades are created or updated for each student
Weighted averages are recalculated automatically (for percentage grades)
Class grades and notes are saved to the student’s record
Bulk importing grades helps you manage assessments faster and ensures your gradebook stays accurate and up to date.