Skip to main content
Schoolyi
School librarian arranging books and planning cards in a bright library

Browse docs

Examinations

Exam session lifecycle

Creating exam sessions, scheduling papers, invigilation, marking, moderation, and publishing results.

Examinations guide for day and boarding schools.

Last updated August 29, 2026

Examination management is organized around sessions (for example Term 1 Finals) that contain scheduled papers per class and subject. An Examination committee can govern paper setting, moderation, seating, and result publication; when no committee is bound, the system preserves coordinator access for those actions. Staff receive the specific setter, marker or invigilator assignments they need, while class teachers use the Class Exams hub for review and optional sign-off.

Create the session against an academic year and keep its dates inside that year. The date validator can flag academic-calendar holidays or non-working days for confirmation, and session creation queues a non-blocking sync of examination days into the calendar. After papers are scheduled, venue allocation and persisted seating are separate preparation steps. Seating is per session, uses active students and room capacity, and does not interpret special-accommodation flags; staff must read those flags on the roster and make any operational adjustment manually.

The end of the cycle has two publication concepts. A paper becomes PUBLISHED so its linked FINAL assessment can be marked. Later, session result publication builds SessionGradeCard rows from published papers, freezes any remaining paper marks, and exposes formal results to families. That session card is distinct from the continuous-assessment term report card at /grades/report-cards.

Simplified exam operations flow.

Setup vs day-of

PhaseWhat happensPrimary screens
SetupCommittee, venues, session, papers, setters, seating, schedule publishDate/exam-setup, /exam-venues, /exam-schedule, /exam-papers
Exam dayHall tickets, roll call, absentees, irregularities, accommodations/exam-day, /exam-day/[paperId]
After examsMarking, freeze, class-teacher sign-off, publish/revoke results, revaluationMarking tasks, session detail, /exam-revaluation

Three-party model

  • Examination committee - sessions, schedule, paper publish, results publish/revoke, revaluation queue
  • Subject teachers - setter tasks, paper builder, marking tasks, invigilation on exam day
  • Class teachers - /my-class/exams review; optional Acknowledge results ready before publish
  • Student - /my-exams schedule and hall tickets after schedule publishDate; marks after results publish
  • Parent - /parent-dashboard/exams?childId= for the selected child (schedule, tickets, published grade cards)

Common questions

Quick answers in plain language.

Is /exam-setup where I configure every exam setting?+

No. /exam-setup is a read-only checklist and launchpad. It reports committee, venue, notification and session readiness, then links to /committees, /exam-venues, /settings/exam-notifications and /exam-schedule where the actual records are changed.

When does a session become visible to students and parents?+

The schedule and hall-ticket surfaces are gated by the session publishDate having passed. Formal marks and session grade cards have a separate resultPublicationStatus gate and remain hidden until results are explicitly published.

Related searches

School leaders and IT teams often search for: exam cycle K-12, and board exam workflow.