Browse help docs
Setting and marking an assessment
From building the questions to returning marked work. The part worth understanding is where the software stops and a teacher starts: nothing the machine calculates becomes a grade until a person puts it there.
For Teachers and heads of department · reviewed 23 August 2026
The 4 points where someone must decide
Everything else can be worked on in any order. These cannot move without a person.
- Hand-inNot submitted → Submitted or late
- Accepting the auto-marksSuggested score → Awarded score
- AI grading suggestionPending → Accepted, edited or rejected
- ReturnGraded → Returned
Build the assessment and its questions
/teacher/assessments


Mrs. Johnson
Teacher
Water systems · end of unit
The question type decides what can be marked without you
Q1 · Which layer holds groundwater?
Multiple choice · 1 mark
Q2 · Calculate the run-off rate
Numeric · 2 marks
Q3 · Explain why the catchment flooded
Long answer · 6 marks
Q4 · Investigation write-up
Rubric · criterion B
An assessment holds questions, and the question type decides what can be marked automatically later. Choosing it thoughtfully now is what saves the marking time.
Objective types — multiple choice, numeric, checklist — carry a correct answer and can be scored without you. Written types cannot, and the software does not pretend otherwise.
- Marked by the software: multiple choice (single and multiple), numeric, checklist.
- Marked by a person: short answer, long answer, rubric-assessed, file upload.
- A rubric question is scored against criteria you already defined, not against a number you invent here.
Students submit
/student/assessments


Mrs. Johnson
Teacher
Submissions
Nothing is scored until a student hands in
Ayaan R.
Handed in 14:02, before the deadline
Navya P.
Handed in 09:15 the next morning
Ishaan V.
Nothing handed in
Late is recorded as a fact about timing. Whether it costs marks is your decision.
Until a student hands in, their work sits as not submitted and nothing is marked. On submission the objective questions are scored immediately, and every written answer is left alone with no score at all.
A submission after the deadline is recorded as late rather than blocked. Whether lateness costs marks is a professional decision, so the software records the fact and leaves the judgement to you.
Gate · Hand-in
Not submitted → Submitted or late
Nothing is scored before a student hands in, so a half-finished answer is never marked. The distinction between submitted and late is recorded as a fact about timing, not applied as a penalty — that stays a teacher's decision.
Review what was auto-scored
/teacher/assessments


Mrs. Johnson
Teacher
Ayaan R. · marking
Suggested and awarded are different columns on purpose
The gradebook reads the awarded column. Until you accept them, the student has no grade.
The objective questions now carry a suggested score. It is not the mark. It sits in its own column beside an empty awarded column, and the gradebook reads the awarded one.
This separation exists so an ambiguous multiple-choice question, or an answer the key got wrong, does not silently become a grade.
Gate · Accepting the auto-marks
Suggested score → Awarded score
Copying auto-marks into the awarded column is a deliberate action by a named person, not something that happened on submission. Until you accept them, the software has an opinion and the student has no grade.
Mark the written answers, with AI drafting if you want it
/teacher/assessments


Mrs. Johnson
Teacher
Q3 · AI grading suggestion
A draft with its reasoning, not a mark
Suggested 4 of 6
PendingIdentifies the cause but does not link it to the catchment data.
the river rose because it rained a lot upstream
Agreement rate this term
68%
kept unchanged
Written answers are yours to mark. If AI grading is switched on, it drafts a suggested score with a rationale and the quote it relied on, so you can see what it read before deciding.
A suggestion is accepted, edited or rejected, and which of those you chose is recorded. Over time that gives an agreement rate — the share of suggestions kept unchanged. A rate near one hundred per cent is usually a sign nobody is really checking rather than a sign the AI is excellent.
Gate · AI grading suggestion
Pending → Accepted, edited or rejected
The grading assistant writes to a suggestion record and has no path to the awarded score. A score it proposes outside the question's range is discarded rather than clamped, because a suggestion that had to be corrected to be usable was not a usable suggestion.
Return the work
/teacher/assessments


Mrs. Johnson
Teacher
Return to students
Marking and releasing are separate acts
Ayaan R.
9 of 12 · marked yesterday
Navya P.
11 of 12 · marked yesterday
Ishaan V.
Not submitted
Return the set together, so nobody gets their mark based on the order you happened to work.
Marked work stays with you until you return it. That is what lets you mark a whole class over several evenings and release it as one set, rather than students receiving marks in the order you happened to work.
Gate · Return
Graded → Returned
A graded submission is not visible to the student until it is returned. Marking and releasing are separate acts because they happen at different times and for different reasons.
Who can approve what
Designations are assigned in IB roles and are separate from the account role somebody signs in with.
| Designation | Sees | Approves |
|---|---|---|
| Teacher | Their own students' submissions | Awarding marks, accepting AI suggestions, returning work |
| Head of department | The department's assessments | The same as a teacher |
| Student | Their own work, once returned | Nothing — they submit, they do not mark |
If something looks empty
A student's marks are blank after they submitted
Auto-scores have not been accepted yet. They sit in the suggested column until somebody copies them across.
A written answer has no suggested score
Correct. The software does not score free text on its own; only the AI assistant drafts one, and only if it is switched on.
The student cannot see their grade
The submission is probably still graded rather than returned. Returning is a separate step.
The AI agreement rate is 100%
Worth a look rather than celebrating. It usually means suggestions are being accepted without being read.
Still stuck?
Bring the unit you are working on. Thirty minutes with someone who has taught the programme.