Exam Management

Bulk Assignment

The Bulk Assignment feature lets you assign multiple exams to multiple classes in a single operation. This is ideal for term-end exams, standardized assessments, or any scenario where several exams need to reach many classes simultaneously. Bulk assignments use the /exams/:id/bulk-assign endpoint.

Bulk Assignment Workflow

Navigate to Bulk Assign

Go to Exams → Bulk Assign from the sidebar or the action menu on the exam listing page.

Select Exams

Choose one or more published exams from the list. Only exams in "published" status are available for bulk assignment. Draft or archived exams are filtered out.

Select Classes

Pick the classes that should receive the selected exams. The class list shows class name, code, and branch for easy identification.

Review the Preview

A preview table shows every Exam × Class combination with the estimated student count. Review this carefully before confirming.

Confirm Bulk Assignment

Click "Assign All" to process the bulk operation. The system reports success and failure counts for each assignment.

Selection Rules

The bulk assignment interface enforces several rules:

Published exams only — Only exams with published status appear in the selection list. Publish draft exams before using bulk assign.
Duplicate prevention — If an exam is already assigned to a class, the combination is skipped automatically. The preview table indicates existing assignments.
Branch filtering — If an exam is scoped to a specific branch, only classes from that branch are available. Organization-wide exams can be assigned to classes from any branch.

Preview Table

Before confirming, the preview table displays:

Exam Name — The exam being assigned
Class Name — The target class
Total Students — Estimated number of students who will receive access (based on current enrollment)
Status — Whether this is a new assignment or already exists

Student Count Estimate

The student count shown in the preview is based on current class enrollment at the time of assignment. If students are added to a class after the assignment, they automatically receive access to the assigned exams.

Results & Error Handling

After processing, the system displays a summary with:

Success count — Number of assignments created successfully
Skipped count — Assignments that already existed
Failed count — Assignments that failed (with error reasons)

Bulk Assignment Strategy

For term exams, prepare all exams in draft status first, then publish them together, and finally use bulk assign to distribute them across classes. This ensures a clean, organized rollout where students receive all their exams at once.

Large Operations

Bulk assignments with many exam-class combinations are processed sequentially on the server. For very large operations (50+ combinations), the process may take a few seconds. The UI shows a progress indicator during processing.

Assigning Exams

Exam Preview