Class gradebook

The gradebook is your working space for recording and reviewing student scores within a class. Each class has exactly one gradebook, and it is organized by the grading periods defined in the class's grading scheme. Within each period you create grade items — individual assessments like quizzes, exams, or activities — and then enter scores for each enrolled student. When you're satisfied with the scores, you publish them so students can see their results and lock the period to prevent further edits before submission.

Setting up grade items

A grade item represents a single graded activity: a quiz, a midterm exam, a project submission. Each grade item belongs to a grading period and, optionally, to a scheme component (e.g., "Written Work") that contributes to the weighted grade calculation.

Create a grade item

1. Open the gradebook — Navigate to Academics → Classes, open the class, and select the Gradebook tab.
2. Select a grading period — Choose the period you want to add an assessment to (e.g., "Midterm").
3. Add a grade item — Select Add Grade Item and fill in:
   • Name — a clear label (e.g., "Quiz 1", "Midterm Exam")
   • Component — the scheme component this item belongs to (e.g., "Quizzes")
   • Max score — the total points possible
   • Due date — optional, used for record-keeping
   • Weight — how much this item contributes within its component
4. Save the grade item — Select Save. The item appears as a new column in the gradebook for that period.

Entering scores

Enter a score for one student

Click the score cell at the intersection of the student's row and the grade item's column, type the score, and press Enter or Tab to move to the next cell. Scores are saved automatically.

Bulk grade entry

Use bulk entry when you want to upload or paste scores for an entire grade item at once — useful after an exam or when importing from a spreadsheet.

1. Open the grade item — In the gradebook, select the grade item column header or open the grade item's detail panel.
2. Select Bulk Enter Grades — Choose Bulk Enter Grades from the actions menu.
3. Provide scores — Enter a score for each enrolled student. To remove a previously entered score, leave the field blank (a null score deletes the existing record).
4. Save — Select Save All. All scores are saved in a single transaction and totals are immediately recalculated so you see up-to-date running grades.

Viewing the full gradebook

The gradebook summary view shows each student's running total per period, computed grade, and final weighted average. Use filters to focus on a specific grading period or component. Open the class and navigate to the Gradebook tab to access this view.

Publishing grades

By default, students cannot see individual scores until you publish the grade item. Publishing makes the scores visible in the student portal while still allowing you to make corrections.

1. Locate the grade item — In the gradebook, find the grade item you want to release.
2. Publish — Select Publish from the grade item's action menu. The item's status changes to Published, and students can immediately view their scores.

Tip: Publish grades to students before you submit the gradebook for approval. Students who can see their scores in advance are more likely to raise discrepancies early, giving you time to make corrections while the gradebook is still editable.

Locking a grading period

Locking a period prevents any further changes to scores or grade items within it. All grade items in a locked period become read-only. Lock a period once you are confident the scores are final and you are ready to submit.

1. Confirm scores are complete — Review the gradebook and resolve any missing or disputed scores.
2. Lock the period — Select Lock Period from the grading period's action menu. The lock is recorded for that class and period combination, making all grade items within it read-only.

Note: If you need to edit scores after locking a period, submit a Grade Period Unlock Request. An administrator must approve the request before the period becomes editable again. See Grade submissions and approvals for details.

Locking individual grade items

You can also lock a specific grade item without locking the entire period. A locked grade item is read-only regardless of whether the period is locked. To return a locked grade item to draft status, use the Set to Draft action.

Exporting the gradebook

Export the gradebook as a spreadsheet for offline review, printing, or record-keeping.

1. Open the gradebook — Navigate to the class's Gradebook tab.
2. Select Export — Choose Export Gradebook from the toolbar. Select the file format (CSV or Excel) and the scope (all periods or a specific period).
3. Download — The export downloads immediately. The file includes each student's scores per grade item, computed period totals, and the final weighted average.

Grade item statuses at a glance