Exam Configuration
Exam configuration controls how the exam behaves for students. These settings are available in the second step of the exam creation wizard or via the /exams/:id/configuration endpoint. Configuration can be edited any time while the exam is in draft status.
Core Settings
These are the fundamental parameters every exam needs.
| Field | Required | Type | Description |
|---|---|---|---|
Duration | Required | number | Total time allowed for the exam in minutes. The timer counts down from this value once the student starts. |
Total Marks | Required | number | The maximum marks for the exam. This is typically auto-calculated from individual question points. |
Passing Marks | Required | number | Minimum marks required to pass. Students scoring below this are marked as failed. |
Max Attempts | Optional | number | Number of times a student can attempt the exam. Leave empty for unlimited attempts. |
Behavior Settings
Control how students interact with the exam — randomization, review options, and tools available during the attempt.
| Field | Required | Type | Description |
|---|---|---|---|
Shuffle Questions | Optional | toggle | Randomize the order of questions for each student attempt to reduce cheating. |
Shuffle Options | Optional | toggle | Randomize the order of answer options within MCQ and multiple-response questions. |
Show Results | Optional | toggle | Allow students to see their score and answers after submission. |
Allow Review | Optional | toggle | Let students review their answers before final submission. |
Show Correct Answers | Optional | toggle | Display the correct answers alongside student responses in the results view. |
Allow Calculator | Optional | toggle | Enable an on-screen calculator tool during the exam. |
Auto-Submit on Timeout | Optional | toggle | Automatically submit the exam when the timer reaches zero. If disabled, students receive a warning. |
Negative Marking
Enable negative marking to discourage guessing. When active, a percentage of the question's marks is deducted for each incorrect answer.
| Field | Required | Type | Description |
|---|---|---|---|
Negative Marking | Optional | toggle | Enable deduction of marks for incorrect answers. |
Negative Marking Percent | Optional | number | Percentage of the question marks deducted for a wrong answer. E.g., 25 means 25% of the question marks. |
Proctoring Settings
BeamEdUp includes a comprehensive proctoring suite to maintain exam integrity. These settings are configured via the /exams/:id/proctoring endpoint or the proctoring tab in the exam wizard.
| Field | Required | Type | Description |
|---|---|---|---|
Enable Proctoring | Optional | toggle | Turn on the proctoring suite for this exam. Requires additional configuration. |
Proctoring Level | Optional | select | Choose from: none, basic (tab/fullscreen detection), moderate (adds camera), or strict (full AI proctoring). |
Require Camera | Optional | toggle | Students must grant camera access before starting. Camera feed is monitored. |
Detect Tab Switch | Optional | toggle | Track when students switch browser tabs. Violations are logged with timestamps. |
Max Tab Switches | Optional | number | Maximum number of tab switches before auto-submission. Blank means warnings only. |
Enable Fullscreen | Optional | toggle | Force the exam to run in fullscreen mode. Exiting fullscreen triggers a violation. |
Block Copy/Paste | Optional | toggle | Prevent students from copying question text or pasting answers. |
Block Right Click | Optional | toggle | Disable the browser context menu during the exam. |
Enable AI Proctoring | Optional | toggle | Use AI face detection to identify suspicious behavior — multiple faces, looking away, etc. |
AI Sensitivity | Optional | select | AI detection sensitivity: low, medium, or high. Higher sensitivity flags more events. |
Advanced Proctoring Options
Additional proctoring controls available at the moderate and strict levels include:
- Record Video / Screen — Capture camera feed or screen activity for post-exam review
- Take Snapshots — Periodic screenshots at a configurable interval (in seconds)
- Face Detection — Detect multiple faces or the student looking away from the screen
- Block Virtual Machine / Remote Desktop — Prevent exam-taking from virtualized environments
- Detect DevTools — Flag students who open browser developer tools
- Auto-Submit on Violation — Automatically submit the exam when the violation threshold is reached
- Live Monitoring — Stream video to the instructor in real-time with intervention capability