Skip to content

Instructor profiles

Applies to: Owner, Administrator, Manager, Instructor, Receptionist, Finance, Viewer (viewing); Owner, Administrator (editing and deleting). Last reviewed: 2026-11-18.

This page covers the Instructors list, viewing one instructor, editing, the four statuses, activating and deactivating, and deleting. To add an instructor, see Registering an instructor.

Who can do what

Action Permission Default roles
See the Instructors list, View, Calendar Instructors.View Owner, Administrator, Manager, Instructor, Receptionist, Finance, Viewer
Edit, change status, Activate, Deactivate, open Sign-in account Instructors.Edit Owner, Administrator
Delete Instructors.Delete Owner, Administrator

Menu items a user may not use are not drawn. The API checks the same permissions, so a hidden action cannot be reached another way.

The Instructors page

Open OPERATIONS > Instructors > Instructors (address /instructors).

Instructors page with summary cards, search box, status filter and instructor table
The Instructors page.

Summary cards

The four cards count all instructors, not only the page shown:

Card What it counts
Total Instructors Every instructor that is not deleted.
Active Status Active.
On Leave Status On Leave.
Inactive Status Inactive.

Suspended instructors are in the total but have no card of their own. If the counts cannot be loaded the cards show "–" and the table still works.

Search and filter

  • Search box ("Search instructor, number, email or phone"): finds instructors whose instructor number, employee number, first name, last name, identity number or email contains what you type. Results update half a second after you stop typing.
  • Status: All, Active, On Leave, Suspended or Inactive.

Table columns

Column Shows
Instructor Name and instructor number.
Contact Phone number and email.
Branch The instructor's branch.
Today's Lessons Lessons starting today for this instructor, not counting cancelled ones.
Total Lessons All lessons ever given to this instructor, not counting cancelled ones (it includes future lessons, completed lessons and no-shows).
Status Active (green), OnLeave (amber), Suspended (red) or Inactive (dark).
Actions The row menu (three dots).

You can sort by Instructor, Branch and Status. Clicking a row opens the View dialog.

Row menu

Menu item Needs What it does
View Instructors.View Opens the instructor's details.
Calendar Instructors.View Opens the instructor's calendar; see Instructor performance.
Edit Instructors.Edit Opens the Edit Instructor form.
Sign-in account Instructors.Edit Link, create or unlink the instructor's login; see Instructor user accounts.
Activate Instructors.Edit Shown only when the status is Inactive. Sets the status to Active.
Deactivate Instructors.Edit Shown for every other status. Sets the status to Inactive.
Delete Instructors.Delete Removes the instructor from the lists.

Viewing an instructor

Click a row, or choose View from the row menu. The dialog shows:

  • Header: full name, instructor number and status.
  • Contact: Email, Phone, Alternate Phone.
  • Employment: Branch, Employee Number, Employment Date.
  • Assigned Vehicle: make, model and registration of the vehicle the instructor currently uses, if any.
  • Licence Codes: the codes the instructor may teach, or "No licence codes assigned."

Buttons at the bottom: Close, Calendar, and the same row menu as in the table.

Screenshot to be added

Screen: Instructor view dialog. Should show: Contact, Employment, Assigned Vehicle and Licence Codes sections.

The View dialog does not list the instructor's students or lessons. Use the Calendar button, or the pages described in Instructor performance.

Editing an instructor

  1. On the Instructors page open the row menu and click Edit.
  2. Change what is needed. The fields are the same as when adding, plus Status.
  3. Click Save Instructor. You see "Instructor updated successfully."
Field Required Rule when editing
Branch Yes Must be an existing branch.
First Name, Last Name Yes Up to 100 characters each.
Identity Number Yes Exactly 13 characters.
Employment Date No
Birth Date Yes in practice Must be before today.
Email Yes Valid email, up to 150 characters.
Phone Number Yes Up to 20 characters.
Status Yes Active, On Leave, Suspended or Inactive.
Licence Codes Yes, at least one The saved list replaces the previous one.

Middle name and alternate phone are cleared on save

The Edit form has no fields for them and sends them empty, so saving an edit blanks any middle name or alternate phone number stored on the record.

Editing an instructor who has a login

When the instructor is linked to a sign-in account, the profile and the account are kept the same:

  • Changing the first name, last name or email on the profile also changes them on the user account, and the new email becomes the sign-in.
  • Changing the email of a linked instructor needs the Users.Edit permission as well. Without it you see: "This instructor's email is also their DriveFlow sign-in. Changing it needs permission to edit users."
  • If another DriveFlow account already uses the new email you see: "Another DriveFlow account already uses this email address."

Common errors when editing

Message Why
Instructor not found. The instructor was deleted by someone else, or is not in your school.
Branch not found. The chosen branch no longer exists or is outside your access.
Licence Code '…' does not exist. A ticked licence code has since been removed. Reopen the form.
A validation message about Identity Number, Date Of Birth, Email or Phone Number See the rules in the table above. The usual causes are an identity number that is not 13 characters, or a birth date left at the day the instructor was added.
Unable to update instructor. Shown together with the specific message when the save is rejected.

Statuses

Status Meaning Can be booked for new lessons? Counts towards the plan limit?
Active Working normally. Yes Yes
On Leave Away for a period. No Yes
Suspended Not allowed to teach for now. No Yes
Inactive No longer teaching at the school. No No

What the status controls, as the code works today:

  • Scheduling. Only Active instructors are offered when a lesson is scheduled, and the scheduling engine only auto-assigns Active instructors. Editing an existing lesson to an instructor who is not Active fails with "Instructor is not active."
  • Existing lessons are not touched. Changing a status does not cancel, move or reassign lessons that are already booked. Check the instructor's calendar and move those lessons yourself; see Lesson management.
  • Login is not touched. The status does not disable the instructor's sign-in account. To stop someone signing in, deactivate their user account under Settings > Users.
  • Plan limit. Only Inactive (and deleted) instructors stop counting.

Changing the status

  • Deactivate (row menu): asks "Are you sure you want to deactivate this instructor?", then sets Inactive and shows "Instructor deactivated successfully."
  • Activate (row menu, only on Inactive instructors): asks "Are you sure you want to activate this instructor?", then sets Active and shows "Instructor activated successfully."
  • On Leave and Suspended can only be set from Edit > Status. To bring such an instructor back, use Edit > Status > Active (the row menu offers only Deactivate for them).
stateDiagram-v2
    [*] --> Active: Add Instructor
    Active --> OnLeave: Edit > Status
    Active --> Suspended: Edit > Status
    Active --> Inactive: Deactivate
    OnLeave --> Active: Edit > Status
    Suspended --> Active: Edit > Status
    OnLeave --> Inactive: Deactivate
    Suspended --> Inactive: Deactivate
    Inactive --> Active: Activate

Deleting an instructor

  1. Open the row menu and click Delete.
  2. Confirm the question: "Are you sure you want to delete this instructor? The instructor will no longer appear in the active instructor list."
  3. You see "Instructor deleted successfully."

What deleting does:

  • The instructor is hidden everywhere (a soft delete). Their past lessons, driving tests, earnings and reviews stay in the database and in reports that list lessons.
  • There is no undo on screen and no "deleted instructors" list.

Deleting cannot be undone on screen

Prefer Deactivate for someone who has taught lessons; it keeps the profile visible and can be reversed.

Limitations and notes

  • Deleting is not blocked by lessons. Unlike vehicles, an instructor with future lessons can be deleted. Those lessons keep the deleted instructor. Check the calendar first.
  • Deleting does not remove the login. The linked user account stays active and keeps its role; it simply no longer matches a profile, so an account limited to its own lessons sees none. Deactivate the user under Settings > Users as well.
  • Deleting does not release the vehicle. A vehicle the deleted instructor was assigned to, or owned, keeps pointing at them until the vehicle is edited.
  • Activation does not re-check the plan limit. The limit is checked when an instructor is added, not when an Inactive instructor is activated.
  • Search placeholder mentions phone, but the list search does not look at phone numbers. (The search box in the page header does match instructor phone numbers.)
  • Status wording. The table and the View dialog show the internal names OnLeave and so on without a space; the filter and the Edit form show "On Leave".
  • Middle name and alternate phone are cleared on save. The Edit form has no fields for them and sends them empty, so saving an edit blanks any middle name or alternate phone number stored on the record.
  • The Edit form reads the branch by matching its name; if two branches share a name the wrong one could be preselected. Check the Branch field before saving in that case.
  • An address /instructors/{id}/edit is referenced in the code of the View dialog but no such page exists; editing is always done in the dialog.