Test grader

Test grader is the default teacher landing page. Take photos of a student's written test and AI grades it — a points score (like 26/29) and grade, feedback written to the student, and optionally an exercise-by-exercise breakdown. A toggle at the top switches between Single test (one student) and Whole group (grade a test for an entire class at once) — either way, each test takes up to 5 photos.

How to Grade a Test

  1. Open the Test grader (/teacher/test-grader)
  2. Enter a test name
  3. Optionally select a student from one of your groups (and, where the group has subjects, a subject) so the result can be saved to them later and active Learning Outcomes can guide the grading context
  4. Add the grading instructions and criteria describing the test — the rubric, point scale, expected answers, anything that matters. If you want the feedback in a specific format, describe it (or paste your template) and the AI follows it exactly; otherwise the feedback opens with the overall picture, then what went well, what to improve, and the most useful next step
  5. Optionally open Add the correct answers or an answer key and add up to 3 photos — a filled-in test, an answer key, or a marking scheme — so the AI has a reference for what counts as right instead of working it out. Entirely optional: writing the correct answers into the instructions above does the same job. In Whole group, one key applies to every student, and the reference photos are never graded as anyone's work
  6. Optionally tick Detailed exercise-by-exercise analysis to also get an editable breakdown — one row per exercise with points and a short note
  7. Capture photos with the built-in camera or upload images from your device (up to 5 per test). Use zoom when you need to capture handwriting clearly
  8. Click Grade the test
  9. Review and edit everything — the feedback, the points score and grade (editing the points recomputes the percentage), and the exercise breakdown. Under the feedback sit the AI grading notes — visible only to you: an editable notes field the student never sees, where the AI flags anything it wasn't sure about (an unreadable page, an ambiguous answer, criteria gaps) instead of guessing silently — and where you can keep your own notes
  10. If you picked a student, save the result to their profile so it's included in their progress history
  11. Download the graded test as a PDF to hand back to the student

Each graded test is saved automatically to your Graded tests history. Open, rename, or delete past tests from the history sidebar.

Grading a Whole Group

Switch to Whole group to grade a stack of tests in one sitting:

  1. Enter the test name and grading instructions once — they apply to every student
  2. Select the group (and, where the group has subjects, a subject)
  3. Add each student's photos (1–5 each) — every student has the same photo card as a single test: click or drag images onto it, or use its Take photo button. For a pile of papers, open the camera on the first student: it shows whose test it's capturing and how many photos they have, and under it a back arrow and a Next button (naming who's up next) step through the class in order — tap Next without capturing to skip a missing test. The "students ready" counter row collapses or shows the photo cards (they tuck away automatically once the run is graded)
  4. Click Grade all. Several students are graded at the same time, so a full class finishes much faster than one after another — each still uses one AI request (however many photos their test has). Results fill in as student rows below as they finish; a failed student can be retried without regrading the rest
  5. Open any student's result to review and edit it — the same editable feedback, score, grade, and exercise breakdown as single mode. A single student can be regraded with the Regrade button inside their opened result, next to Save and Download; running Grade all again regrades the whole class with the current instructions — useful after correcting the rubric
  6. Save results individually, or Save all to students at once

The whole run is saved as one entry in your Graded tests history — reopen it any time and it restores the full session in Whole group mode: the group, your instructions, and every student's photos and results, still editable. Edits autosave into the record as you make them, so nothing is lost between sessions.

What Gets Saved

When you save a graded test to a student, it appears on their Progress Card with the test name, subject, score and grade, feedback, and the exercise breakdown when one was generated — laid out exactly as in the Test grader. Everything saved is what the student sees — the AI's grading notes to you are never part of it. This lets Test grader results sit alongside assessments, activities, and manual grades.

The saved record stays editable: open it in Groups and click the pencil to revise the feedback, points, grade, or exercise breakdown in place — editing the grade also updates the linked entry in the student's grades.

Default Requirements

Set recurring grading instructions in Account settings -> Personalization -> Test grader. Use this for marking policies, preferred feedback style, point-scale rules, or subject-specific expectations you do not want to retype every time.

When the selected student, group, and subject have active Learning Outcomes, Test grader uses them automatically alongside your grading instructions and default requirements.

Tips for Accurate Grading

  • Make sure the photo is clear and well lit
  • Use zoom to capture handwriting details
  • Include the subject, grading criteria, and any special expectations in the context
  • Add a clear test name so it is easy to find in the student's history later

Teaching With It

Grading from a photo is the capture step of a bigger routine: the saved result — feedback included — becomes context the assessment generator can build on for that student, so the next feedback addresses what they actually got wrong. Treat the grade itself as a performance signal to track over time; the feedback and the exercise breakdown are where the teaching value is. The full routine is in Formative assessment, and how the pieces connect in How TeachersFlow fits together.