Exam Management

Publishing & Managing

Managing exams involves tracking their lifecycle from creation through completion, publishing when ready, editing as needed, and monitoring performance. The exam detail page in the Organization Portal is your control center for all management operations.

Exam Status Lifecycle

Every exam moves through a defined set of statuses. Understanding these transitions helps you manage the exam workflow effectively.

Field	Required	Type	Description
Draft	Optional	status	Initial state after creation. All settings, questions, and scheduling can be freely edited. Not visible to students.
Published	Optional	status	Exam is live and available for assignment. Students can see and start the exam if assigned. Limited editing allowed.
Scheduled	Optional	status	Exam has a future start date. Automatically transitions to In Progress when the start time is reached.
In Progress	Optional	status	Students are actively taking the exam. No configuration changes allowed. Monitoring and proctoring are active.
Completed	Optional	status	All attempts are finished or the end date has passed. Results are available for grading and analytics.
Archived	Optional	status	Exam is retired from active use. Not visible in default listings. Can be restored or cloned to create a new version.

Status Transitions

The typical flow is: draft → published → scheduled (if a future start date is set) → in_progress → completed → archived. You can move a published exam back to draft if no students have started it. Archived exams can be cloned to create a new draft.

Publishing an Exam

Publishing transitions an exam from draft to published status, making it available for assignment. Before publishing, ensure:

At least one question has been added to the exam
Duration and passing marks are configured
All questions display correctly in preview mode
Scheduling and proctoring settings are finalized

Publishing Is Not Assignment

Publishing makes the exam available but does not send it to students. You must explicitly assign the exam to classes or individual students after publishing. This two-step process lets you control exactly when and who receives the exam.

Editing After Creation

What you can edit depends on the exam's current status:

Draft — Everything is editable: title, description, questions, configuration, scheduling, and proctoring settings
Published — You can edit title, description, scheduling, and assignment. Adding or removing questions is restricted if students have already been assigned
In Progress — Only the end date can be extended. All other settings are locked to maintain fairness
Completed / Archived — Read-only. Use the Clone feature to create an editable copy

Cloning Exams

The Clone action (available from the exam action menu or the /exams/:id/clone endpoint) creates a copy of the exam in draft status. The clone includes all questions, configuration, and proctoring settings but resets scheduling and assignments. Use cloning to:

Reuse an exam for a new term or batch
Create exam variants with minor changes
Restore an archived exam for active use

Archiving & Deleting

Archiving moves a completed exam to the archived status. Archived exams are hidden from default listings but remain accessible through the status filter. Student results and analytics are preserved.

Deleting permanently removes an exam and all its data. Deletion is only allowed for draft exams with no student attempts. Published or completed exams must be archived instead.

Deletion Is Permanent

Deleting an exam removes all associated questions, assignments, and configuration. This action cannot be undone. If you want to remove an exam from active use while preserving data, use Archive instead.

Exam Analytics Overview

The exam detail page includes an insights panel showing real-time analytics. These metrics help you evaluate exam effectiveness and identify areas for improvement.

Field	Required	Type	Description
Total Attempts	Optional	number	Number of students who started the exam.
Completed Attempts	Optional	number	Number of students who submitted the exam.
Average Score	Optional	number	Mean score across all completed attempts.
Passing Rate	Optional	percentage	Percentage of completed attempts that met the passing marks threshold.
Top Score	Optional	number	Highest score achieved across all attempts.
Lowest Score	Optional	number	Lowest score among completed attempts.

Use Analytics to Improve

A low passing rate may indicate overly difficult questions or insufficient preparation time. A very high average score might mean the exam is too easy. Use these insights to calibrate future exams. For detailed per-question analytics, visit the Result Analytics section.

Exam Preview

Learner Dashboard