Instructor reports¶
Applies to: school staff with Reports.View plus Instructors.View, Lessons.View, DrivingTests.View or InstructorEarnings.View, depending on the report. Last reviewed: 2026-11-18.
There is no single "instructor report". Figures per instructor appear in five places. This page lists them, explains each calculation, and describes the Instructor Earnings Report in full.
Where instructor figures appear¶
| Where | Section | Needs (besides Reports.View and the Reports plan feature) |
|---|---|---|
Reports Overview (/reports) |
Instructor Performance | Instructors.View |
| Lesson Report | Instructor Performance | Lessons.View |
| Sign-Off Report | Instructor Sign-Offs | Lessons.View |
| Driving Test Report | Instructor Test Performance | DrivingTests.View |
| Instructor Earnings Report | whole page | InstructorEarnings.View and the Instructor Earnings plan feature (Enterprise) |
Instructor Performance on the Reports Overview¶
Sidebar > REPORTING > Reports > Overview. The section Instructor Performance "in selected period" is shown to users with Instructors.View; for others the server sends no instructor rows at all.
| Column | Meaning |
|---|---|
| Instructor | Every instructor of the school (or of the selected branch), including those with no lessons in the period. |
| Lessons | The instructor's lessons starting in the period, every status. |
| Completed | Status Completed. |
| Cancelled | Status Cancelled. |
| Hours | Time (end minus start) of the instructor's non-cancelled lessons in the period. |
Sorted by most lessons, then by name. Ten rows per page (10, 20, 50 or 100 selectable).
With a branch selected, the list holds the instructors who belong to that branch, and only lessons at that branch are counted.
This section cannot be exported.
Instructor Performance on the Lesson Report¶
Columns Instructor, Lessons, Completed, Scheduled, Cancelled, Hours, Completion. Only instructors with at least one lesson in the period are listed, most completed lessons first. See Lesson Report.
Instructor Sign-Offs on the Sign-Off Report¶
Columns Instructor, Sign-Offs, Instructor Signed, Student Signed, Fully Signed. See Sign-Off Report.
Instructor Test Performance on the Driving Test Report¶
Columns Instructor, Tests, Passed, Failed, Pass Rate, where Pass Rate = Passed x 100 / (Passed + Failed). See Reports Overview, Driving Test Report and Vehicle Report.
Instructor Earnings Report¶
The report shows each instructor's share of the lessons they completed in a period, what the school keeps, and how much of the instructors' share is still owed. How shares are set up, when an earning is created and how earnings are marked as paid belong to the Instructor Earnings feature and are described in the instructor documentation; this section covers the report only.
Where to find it¶
Sidebar > REPORTING > Reports > Instructor Earnings Report (/reports/instructor-earnings). Page title Instructor Earnings Report, subtitle "Instructors' share of the lessons they completed, owed and paid."
Who may open it¶
| Requirement | Detail |
|---|---|
| Plan features | Instructor Earnings (Enterprise). The menu group itself also needs the Reports feature. |
| Permissions | Reports.View and InstructorEarnings.View (both) |
Note
An instructor who only has InstructorEarnings.ViewOwn uses the Earnings page under Instructors, not this report.
If the plan does not include the feature, the page shows "Instructor Earnings is part of the Enterprise plan" with a View plans button for users with Subscription.View.
Filters¶
From, To, Branch (All branches or one), Period quick ranges, Generate Report and Export, as on the other reports. Both dates are included. Messages: "Please select a date range.", "The start date cannot be after the end date."
Screenshot to be added
Screen: Instructor Earnings Report. Should show: summary cards and the Earnings per Instructor table.
Summary cards¶
| Card | Figure | Sub-text |
|---|---|---|
| Lessons | Number of earnings (one per completed lesson with a share) in the period | "Worth R ..." - the total lesson value |
| Instructor Share | Total of the instructors' amounts | "n instructor(s)" |
| Owed | Instructors' amounts not yet marked as paid | "R ... paid" |
| School Share | Total of the school's amounts |
For each earning, lesson value = instructor amount + school amount.
Earnings per Instructor¶
| Column | Meaning |
|---|---|
| Instructor | |
| Lessons | Number of earnings in the period. |
| Lesson Value | Sum of the lesson prices. |
| Instructor Share | Sum of the instructor's amounts. |
| School Share | Sum of the school's amounts. |
| Owed | Instructor's amounts not yet paid out. |
| Paid | Instructor's amounts marked as paid. |
Empty text: "No earnings in this period."
Earning Details¶
"Every lesson completed by an instructor with a share set, within the selected period."
| Column | Meaning |
|---|---|
| Lesson | Lesson number. |
| Date | Lesson date. |
| Student | |
| Instructor | |
| Vehicle | |
| Lesson Price | The lesson value the share was calculated on. |
| Share | The share rule that applied (a percentage or a fixed amount). |
| Instructor | Instructor's amount. |
| School | School's amount. |
| Status | Paid or Owed. |
Example¶
Period 1 to 31 October: Lessons 180 (Worth R 63 000.00), Instructor Share R 25 200.00 (4 instructors), Owed R 9 800.00 (R 15 400.00 paid), School Share R 37 800.00. The school owes its instructors R 9 800.00 for October lessons; R 15 400.00 has already been paid out.
Export¶
| Menu item | Rows in the file |
|---|---|
| PDF (per instructor), Excel (per instructor) | The Earnings per Instructor table: Instructor, Lessons, LessonValue, InstructorShare, SchoolShare, Owed, Paid. |
| PDF (every lesson), Excel (every lesson), CSV (every lesson) | The Earning Details rows: LessonNumber, LessonDate, StudentName, InstructorName, VehicleName, LessonAmount, ShareType, ShareValue, InstructorAmount, SchoolAmount, EarnedAt, IsPaid, PaidAt. |
There is no CSV for the per-instructor totals. Files are named instructor-earnings-report-<date and time>. See Exporting reports. Messages: "Please select a date range first.", "Unable to export the instructor earnings report.".
Limitations and notes¶
Warning
Lessons with no share set do not appear in the Instructor Earnings Report; it is not a count of all completed lessons. Use the Lesson Report for that.
- Instructor performance report without a screen. The API offers a fuller instructor performance report (
GET api/reports/instructors/performanceand/export, needingReports.ViewandInstructors.View) with assigned, completed and cancelled lessons, no-shows, minutes, scheduled / passed / failed driving tests, pass rate and active students per instructor. No page in the web application calls it, so it cannot be opened or exported from the screens. - The Overview's Instructor Performance has no export and no pass rates.
- Instructor reviews (ratings by students) are not part of any report; see Instructors > Reviews.
- None of the instructor sections is limited to "own figures" for an instructor who has been given
Reports.View; they show every instructor. - The detailed calculation of an earning (share types, own-vehicle versus school-vehicle rules) was not re-derived for this page; see the instructor earnings documentation.
Related articles¶
- Lesson Report - Instructor Performance per period
- Sign-Off Report - Instructor Sign-Offs
- Reports Overview, Driving Test Report and Vehicle Report - Instructor Test Performance
- Exporting reports - file formats and names
- Instructor earnings - setting up shares and paying out earnings