Lesson sign-off¶
Applies to: Owner, Administrator, Manager (web); Instructor (mobile app); Student (portal or mobile app). Last reviewed: 2026-11-18.
A lesson is completed by two signatures: the instructor signs first, then the student. This page explains how each signature is captured and what the rules are.
The flow¶
stateDiagram-v2
direction TB
state "Confirmed or In Progress" as Ready
state "Awaiting Student Sign-off" as Awaiting
Ready --> Awaiting: Instructor signs (with optional lesson notes)
Awaiting --> Completed: Student signs
Important
The order is fixed. The student cannot sign before the instructor.
Who can do what¶
| Action | Where | Needs |
|---|---|---|
| Record the instructor's signature | Web: row menu, Instructor Sign-off | To see the menu item: (Lessons.Edit or Lessons.Reschedule) and Lessons.Manage. The server needs Lessons.Edit. |
| Record the instructor's signature | Instructor mobile app | The instructor's own lesson |
| Record the student's signature on the school's device | Web: row menu, Student Sign-off | Same as the web instructor sign-off |
| Student signs for themselves | Student portal: Sign off lesson; or the mobile app | The student's own lesson |
With the default roles, the web menu items are visible to the Owner, Administrator and Manager. Instructors normally sign in the mobile app (see the mobile application guide).
An instructor who only manages their own lessons can only sign off their own lessons; another instructor's lesson is reported as "Lesson not found."
When sign-off is allowed¶
| Rule | Message when broken |
|---|---|
| Lesson is not cancelled | "Cancelled lessons cannot be signed off." |
| Lesson is not a no-show | "No-show lessons cannot be signed off." |
| Lesson is not already completed | "Lesson is already completed." |
| Instructor has not already signed | "Instructor sign-off has already been completed." |
| Not before the day of the lesson, when No status changes before the date is on | "A lesson can't be signed off before its date (25 Nov 2026). Change it on the day, or switch off "No status changes before the date" under Settings > Scheduling." |
| Student signs only when the lesson is Awaiting Student Sign-off | "This lesson is not awaiting student sign-off." |
The date rule checks the date only. A lesson can be signed off on its day before its start time.
In the web menu, Instructor Sign-off is offered for lessons that are Confirmed or In Progress. A lesson that is still Scheduled must be marked Confirmed or In Progress first.
Instructor sign-off on the web¶
- On Lessons > Lessons (or the student's Lessons tab), open the row menu and click Instructor Sign-off.
-
The Complete Lesson dialog opens: "Review the lesson details and sign to confirm that the lesson was completed."
Screenshot to be added
Screen: Complete Lesson dialog. Should show: Lesson Information, Lesson Notes, the Lesson Sign-off panel and the signature box.
-
Check Lesson Information: Student, Lesson (number), Date, Time, Duration and Current Status.
- In Lesson Notes, type anything worth recording about the lesson. The box starts with the lesson's existing notes.
- The Lesson Sign-off panel explains "After you sign this lesson, it will be sent to the student for their sign-off." and shows Instructor: Sign-off required and Student: Awaiting student.
- Under Instructor Sign-off, sign in the box marked Sign here, using a finger, stylus or mouse. Click Clear to start again.
- Click Sign & Continue.
Message: "Instructor sign-off recorded. The lesson is now awaiting student sign-off."
If the box is empty: "Please provide your signature before continuing."
What is saved:
- the signature image, and the date and time of signing;
- who signed: on the web this is recorded as the lesson's instructor, whoever was logged in; in the instructor app it is the instructor who actually signed;
- the notes, added to the lesson's notes on a new line;
- the status Awaiting Student Sign-off.
No notification is sent at this point. The student sees the lesson waiting for their signature in the portal.
Student sign-off¶
There are two ways.
The student signs in the portal or app¶
- In the portal, the student opens My lessons (or My calendar), opens the lesson's menu and chooses Sign off lesson. The item appears only after the instructor has signed.
- The Sign off lesson dialog says "Sign below to confirm this lesson took place. This completes the lesson."
- The student signs and submits.
Message: "Thanks, your lesson is signed off."
| Situation | Message |
|---|---|
| No signature | "Please sign before submitting." |
| Instructor has not signed yet | "Your instructor needs to sign off this lesson first." |
| Lesson is in another status | "This lesson isn't waiting for your signature." |
The student signs on the school's device¶
Use this when the student is in the office or at the car with a staff tablet.
- Open the row menu and click Student Sign-off (shown for lessons Awaiting Student Sign-off).
-
The Student Sign-off dialog opens, headed Confirm Your Lesson: "Review the lesson details below and sign to confirm that you received the lesson."
Screenshot to be added
Screen: Student Sign-off dialog. Should show: lesson details, "Instructor has signed this lesson" panel, Instructor Notes and the "Your Signature" box.
-
It shows the lesson information, the instructor and vehicle, a green panel Instructor Sign-off - Instructor has signed this lesson. Signed, and the Instructor Notes if there are any.
- The student signs under Your Signature ("Sign below using your finger, stylus or mouse to confirm this lesson."). Clear wipes the box.
- Click Sign & Confirm.
Message: "Lesson signed off successfully."
If the box is empty: "Please provide your signature before confirming the lesson."
Note
Both sign-off dialogs can only be closed with Cancel or the close button; clicking outside the dialog does not close them, so a signature in progress is not lost by accident.
After the student signs¶
- The student's signature and the time are saved.
- The lesson becomes Completed.
- The instructor's earning for the lesson is recorded, if Instructor Earnings is in use.
- If this was the student's last outstanding lesson, their status changes to Training Completed.
- The student receives a "lesson completed" notification showing lessons completed and remaining. See Notifications.
See Lesson attendance for the effect on the package figures.
The signature image rule¶
A signature is stored as a picture. The server accepts it only when:
- it is a PNG image sent as a data address starting with
data:image/png;base64,; - the contents really are a PNG file (the file header is checked);
- it is no larger than 512 KB.
Anything else is refused before it is stored:
| Message | Cause |
|---|---|
| "Instructor signature is required." / "Student signature is required." | Nothing was sent. |
| "Instructor signature must be a PNG image." / "Student signature must be a PNG image." | Wrong format, or not a real PNG. |
| "Instructor signature is too large." / "Student signature is too large." | Over 512 KB. |
The signature boxes in the web application, the portal and the mobile apps all produce PNG images, so staff and students do not normally see these messages. A drawn signature is typically a few tens of kilobytes.
The Sign-Off Report¶
Reports > Sign-Off Report (/reports/sign-offs) lists lesson sign-offs. It is shown to users with Reports.View and Lessons.View, on plans that include Reports. See the reports guide for its contents.
Example¶
Sipho has just finished Thandi's 10:00 lesson.
- In the instructor app, Sipho opens the lesson, adds the note "Parallel parking improving, practise hill starts", signs, and submits. The lesson shows Awaiting Student Sign-off.
- Thandi opens the student portal on her phone, goes to My lessons, chooses Sign off lesson, signs and submits.
- The lesson shows Completed. Thandi receives a message that she has completed 6 of 10 lessons.
If Thandi has no phone with her, a manager opens Lessons > Lessons, finds the lesson, chooses Student Sign-off and hands her the tablet.
Limitations and notes¶
- A signed-off lesson cannot be reopened. There is no way to remove a signature or return a Completed lesson to an earlier status.
- A lesson stuck at Awaiting Student Sign-off stays there until the student signs or staff capture the signature. There is no time limit, no automatic completion and no reminder. It can still be cancelled.
- The web "Instructor Sign-off" records the lesson's instructor as the signer, even when a manager signs on their behalf.
- Receipt fields are unused. The sign-off record has a receipt number and a receipt-sent time, but nothing fills them in and no sign-off receipt is produced.
- No assessment or scoring. Apart from free-text notes, the sign-off captures no skills checklist, rating or progress score. (The "assessment" package type and student assessment invoices are a different feature; see the package guide.)
- Signatures are not displayed in the Lesson Details dialog. Lesson Details shows schedule, people, location and notes only.
- The dialog title differs from the menu item. The menu says Instructor Sign-off; the dialog it opens is titled Complete Lesson.
- Awaiting Instructor Sign-off exists as a status but is never set; see Lesson attendance.
Completed lessons cannot be reopened
Once the student signs, the lesson is Completed for good. Check the details before signing.
Related articles¶
- Lesson attendance - statuses, no-shows and completing a lesson.
- Lesson history - finding past lessons and their notes.
- Scheduling settings - the No status changes before the date switch.
- Instructor features in the mobile app - signing off from the instructor app.
- Sign-off report - reporting on sign-offs.
- Instructor earnings - earnings recorded on completion.