Test results¶
Applies to: Owner, Administrator, Manager, Receptionist, Instructor. Last reviewed: 2026-11-18.
After a student has written their learner's test or taken their driving licence test, record whether they passed. The result updates the student's status and, for a learner's test, whether they hold a learner's licence.
Who can record a result¶
The Record Result menu item is shown to users with DrivingTests.Edit, for tests with status Booked. By default: Owner, Administrator, Manager, Receptionist and Instructor.
When a result can be recorded¶
- The test must be Booked.
-
If No status changes before the date is switched on for the branch (the default), the result cannot be recorded before the test date:
"A driving test result can't be recorded before its date (14 Dec 2026). Change it on the day, or switch off "No status changes before the date" under Settings > Scheduling."
Only the date is compared. On the day of the test the result can be recorded at any time.
Recording a result¶
- Go to Driving Tests (or the student's Driving Tests tab).
-
Open the row menu (three dots) and click Record Result. The Record Test Result dialog opens.
Screenshot to be added
Screen: Record Test Result dialog. Should show: booked details read-only at the top, Passed and Failed cards, Result Comments and the warning box.
-
Check the booked details, which are shown read-only: Student, Test Type (with the test number underneath), Test Date, Test Time, Testing Centre, and for a driving licence test the Instructor and Vehicle, then the Booking Reference.
- Fill in or correct the Examiner (optional, up to 200 characters). It starts with the name entered at booking.
-
Under Test Result, click one of the two cards:
Card Text Passed "Student passed the test." Failed "Student did not pass the test." -
Optionally type Result Comments (up to 1000 characters). "Added to the test's notes."
- Read the box at the bottom, which tells you what will happen:
- Passed, learner's test: "Recording this result as passed will update the student's learner's test status."
- Passed, driving licence test: "Recording this result as passed will update the student's driving test status."
- Failed: "The test will be recorded as failed. The student can be booked for another test later."
- Click Save Result. The button is disabled until a result is chosen.
Message: "Driving test completed successfully."
What the result changes¶
The test's status becomes Completed and its Result is set to Passed or Failed. The examiner name is updated if you entered one, and your comments are added to the test's notes on a new line.
Learner's licence test¶
| Result | Learner's licence | Student status |
|---|---|---|
| Passed | The student is marked as having a learner's licence | Registered, Learners Pending or Learners Failed becomes Learners Passed. A student already in another status (for example In Training) keeps it. |
| Failed | The student is marked as not having a learner's licence | Registered, Learners Pending or Learners Failed becomes Learners Failed. Other statuses are kept. |
Once the student has a learner's licence, lessons can be booked for them without restriction, and a driving licence test can be booked when their status allows it.
Note
The learner's licence expiry date is not set by recording the result. Enter it on the student record if you track it; see the student guide.
Driving licence test¶
| Result | Student status |
|---|---|
| Passed | Test Passed |
| Failed | Test Failed |
A student whose status is Test Failed can be booked for another driving licence test and, with an extra lesson, for more lessons.
Failed learner's test: upcoming lessons¶
A student without a learner's licence may not drive. So when you record a failed learner's test and the student has upcoming Scheduled or Confirmed lessons, you are asked before saving:
Upcoming lessons This student has 3 upcoming lesson(s) booked. Without a learner's licence they can't drive until they pass a new learner's test. Do you want to cancel these lessons?
| Button | Result |
|---|---|
| Cancel lessons | The result is saved and each upcoming lesson is cancelled with the reason "Learner's test failed". |
| Keep lessons | The result is saved and the lessons are left as they are. |
| Back | Nothing is saved; you return to the dialog. |
If the student has no upcoming lessons the question is not asked.
When lessons are cancelled this way:
- Each goes through the normal cancellation, so the student and instructor are notified and the lessons return to the package. See Lesson cancellation.
- The branch's cancellation notice still applies to users who are not Owner, Administrator or Manager. A lesson that is too close to cancel is left booked.
- The success message tells you the outcome, for example: "Driving test completed successfully. 2 upcoming lesson(s) cancelled. 1 lesson(s) could not be cancelled (inside the cancellation notice window) and were left booked."
Tip
If you chose Keep lessons, remember that those lessons stay in the diary. New lessons for the student cannot be booked until another learner's test is booked.
Messages you may see¶
| Message | Cause |
|---|---|
| "Please select a test result." | No card chosen. |
| "Driving test not found." | The test no longer exists. |
| "Cancelled driving tests cannot be completed." | The test was cancelled. |
| "Driving test is already completed." | A result was already recorded. |
| "A driving test result can't be recorded before its date ..." | See above. |
| "Could not check the student's upcoming lessons: ..." | The lesson check failed; the result can still be saved, and no lessons are cancelled. |
| "Unable to record test result." | The server gave no reason. |
Correcting a result¶
Results cannot be changed
A result cannot be changed once saved. A Completed test cannot be edited, reopened or cancelled.
If a result was recorded wrongly:
- correct the student's status and learner's licence on the student record (see the student guide); and
- if needed, book a new test and record the right result on it.
Example¶
Thandi wrote her learner's test this morning and failed. She has three lessons booked for next week.
- Go to Driving Tests, find Thandi's test, open the row menu and click Record Result.
- Click Failed. In Result Comments type "Failed road signs section".
- Click Save Result. The Upcoming lessons question appears.
- Click Cancel lessons.
The test shows Completed with result Failed, Thandi's status is Learners Failed, her three lessons are cancelled and back in her package, and she and her instructor are notified of the cancellations. Book her next learner's test, then re-book her lessons from that test date.
Limitations and notes¶
- Results cannot be corrected or undone in the application.
- No test score, error sheet or document can be attached to the result here; only Passed or Failed, the examiner and comments.
- No notification is sent for the result itself. The student and instructor are only notified about any lessons cancelled as a consequence.
- Passing the driving licence test sets the status to Test Passed, not Licensed. Moving the student on to Licensed, and completing their course, is a separate step; see the student and course guides.
- A failed learner's test clears the learner's licence flag even if the student already held a valid learner's licence. Booking a learner's test for a student who has one is refused, so this normally cannot arise.
- The Driving Test Report counts passes and fails by result: results are stored as status Completed with a Passed or Failed result, and the report's Passed, Failed and Pass Rate figures use that result, as do the cards at the top of the Driving Tests page. See Test history.
- The statuses Passed and Failed are never used for a test; see Scheduling a test.
Related articles¶
- Booking a test - recording the test booking.
- Scheduling a test - test statuses, changing and cancelling.
- Test history - past results and the Driving Test Report.
- Lesson cancellation - what happens to cancelled lessons.
- Student status management - correcting a student's status.