Skip to main content

​
Handgrading

Handgrading is the staff-facing interface for human review of student submissions. Graders view a submission’s files and artifacts, apply rubric checks, leave inline annotations, and mark grading complete so instructors can release results to students. Instructors can define multiple handgrading rubrics for each assignment, though the most typical setup is a single “Grading Rubric” whose score (combined with the autograder score) determines the submission’s grade. For the rubric schema and configuration, see Rubrics. For assigning graders to submissions or rubric parts, see Grading Assignments.

​
Grading status dashboard

The assignment landing page shows a grading status dashboard with:
  • Overall grading progress across all submissions
  • Individual grader workload and completion status
  • Pending grading tasks organized by grader
  • Quick access to ungraded submissions
Instructors use this view to monitor progress, identify bottlenecks, and rebalance workload among TAs before releasing grades.

​
Grading submissions assigned to you

When you have submissions assigned to grade, a summary appears on the assignment’s landing page.
Handgrading page showing assigned submissions list
Click a submission to open the grading interface. The interface includes:
  • A Files tab showing the submission’s source files with syntax highlighting. Plaintext and markdown files render directly in the browser.
  • An Artifacts tab showing any files generated by the autograder (logs, reports, coverage data, etc.). Rubric checks can link directly to specific artifacts.
  • A rubric sidebar showing the parts you have been assigned to grade.
If you are assigned only part of a rubric, click View + Grade Full Rubric to access the full rubric. You can also click Grade to score the submission as a whole.
Grading interface with rubric sidebar and code view

​
Grading submissions without an assignment

If you have not been assigned any submissions, the assignment landing page shows the full list of submissions instead.
All submissions list for unassigned grading
Click a student or group name to open the grading interface for that submission.
Individual submission grading interface

​
Viewing files and artifacts

The grading interface renders submission files and grader-published artifacts as follows: There is no in-browser PDF viewer and no rendering of HTML files from the repository. A PDF or a .html file in the submission is a binary or source file like any other, so you get the download link or the source view. Artifacts are files configured by the instructor in the autograder settings (for example, reports/*.md or output.txt). They typically contain test output, generated reports, coverage data, or other deliverables that provide context for grading.

​
Applying rubric checks and annotations

Rubric checks are applied from the rubric sidebar. For checks that target specific lines of code or sections of an artifact, you can leave inline annotations:
  1. Open the Files or Artifacts tab.
  2. Click on the line (or section, for markdown) you want to annotate.
  3. Choose a rubric check from the annotation menu.
  4. Add an optional comment.
Annotations remain visible across grading sessions and become visible to students when the review is released.

​
Grade overrides

When overriding a calculated grade, you can add a note explaining the reason for the override. The note is visible in the grading interface to track why a manual adjustment was made.

​
Individual grading for group assignments

For group assignments, rubric parts can be configured so each group member is graded separately rather than once for the entire group.

​
Individual grading mode

Mark a rubric part with is_individual_grading: true:
When grading a group submission, the rubric sidebar displays a separate section per group member, each labeled with the student’s name. Checks and comments are scoped to the specific student.

​
Assign-to-student mode

Mark a rubric part with is_assign_to_student: true to let the grader choose which student a part applies to (or skip it if it doesn’t apply to anyone):
This is useful when different students are responsible for different components of a group project.
A rubric part cannot be both is_individual_grading and is_assign_to_student. Choose the mode that best fits your grading needs.

​
Viewing individual scores

When a group submission has individual grading components, the submission view shows a Scores by student breakdown:
  • Shared: Points from whole-group rubric items, autograder, and manual adjustments
  • Individual: Points from that student’s individual rubric sections
  • Total: Combined score, capped to the assignment maximum if configured
Students see only their own breakdown; instructors and graders see all group members’ scores. Tooltips on the assignments table also show individual score breakdowns.

​
Completing a review

Once all required rubric checks are applied, click Complete Review to mark the review done. This does not release the review to the student; it indicates to the instructor that the review is ready to be released. When you complete an assigned rubric part, Pawtograder will also automatically complete any other review assignments on the same submission whose assigned parts are a subset of yours. For example, if you complete parts A, B, and C, another grader assigned only to A+B has their assignment auto-completed.

​
Editing after completion

TAs can edit or delete rubric scores, comments, and annotations after marking a review complete. Just navigate back to the submission and make your changes — the review stays marked complete, and the updates take effect immediately. There is no need to “uncomplete” a review to make corrections. Once an instructor releases the review to the student, only instructors can make further edits. See Grading after release below.

​
Bulk operations

​
Finalize grading

Use Finalize grading on the assignment’s Dashboard tab to mark every eligible submission review complete in one step:
  1. Click Finalize grading.
  2. A popover summarizes:
    • How many of the incomplete submissions can be finalized
    • How many have missing required rubric checks (these are skipped)
  3. Click the checkmark to confirm.
Pawtograder only completes a review if all required rubric checks are applied and every criterion’s minimum and maximum check counts are satisfied. Reviews with missing requirements are skipped. The button is not scoped to a row selection: it always acts on every eligible review in the assignment. Use the Grading Complete column filter on the submissions table to focus on only complete or only incomplete submissions.
Finalizing marks reviews complete but does not release them to students. Use the release controls separately to make grades visible.

​
Grading progress

There is no second, finer-grained bulk-completion flow. The Grading Progress Dashboard tab on the Grading Assignments page is read-only: it reports each TA’s pending and completed counts, a completion percentage, and a status badge. Its one action, Generate Reminder Email, builds a reminder listing outstanding work and copies it to your clipboard for you to send yourself. See Grading Status.

​
Reassigning grading work

Instructors can reassign a submission or rubric part to a different grader at any time, even after grading has been partially or fully completed. Reassignment is useful when:
  • A grader is unavailable and their work needs to be redistributed
  • Workload needs to be rebalanced across graders
  • A specific grader’s expertise is needed for certain submissions
There are two entry points, both on the assignment’s Grading Assignments page. Click the edit icon on a row of the All Assignments table to change a single review’s assignee, or follow the Reassign Grading by Grader link to redistribute one grader’s whole remaining queue. See Assigning Grading Tasks. Existing grading work (scores, comments, annotations) is preserved. The new grader sees the work in their pending list — and even if they had already marked a different rubric part of the same submission complete, the reassigned part still arrives as pending rather than being treated as already done.

​
Submission resubmissions

When a student submits a new version of their work, Pawtograder handles the reassignment automatically:
  • Review assignments move to the new active submission and are reopened (completion status cleared).
  • Existing comments remain attached to the original submission they were written for, so graders can see their previous feedback in context.
  • The new submission starts fresh without carrying over old comments.

​
Grading after release

Once an instructor releases a review to students, grading comments on that review are locked for non-instructor graders. Only instructors can edit or delete comments on a released review.
After a review is released to students, grading comments can no longer be edited or deleted by graders. This protects the integrity of feedback that students have already seen. If changes are needed after release, an instructor must unrelease the review, make edits, and re-release it.
Note that self-review rubric items do not support regrade requests — students cannot request regrades on items they evaluated themselves during the self-review process.

​
Rerunning the autograder

Instructors can rerun the autograder on an existing submission without creating a new submission — useful after fixing an autograder bug, updating tests, or regrading with a different grader version.
  1. Open the submission to regrade.
  2. Click Rerun Autograder.
  3. In the regrade dialog:
    • Select a grader version from the dropdown, or enter a specific commit SHA.
    • Choose whether to auto-promote the regraded submission to be the active submission.
  4. Click Regrade.
The autograder runs on the existing submission and updates its results when the regrade completes.
Use the Test Insights dashboard to launch regrading directly from error groups, with affected submissions automatically preselected.