Skip to content

Instructor assignments

Applies to: Owner, Administrator (assigning a vehicle needs Vehicles.Edit or Vehicles.Create); everyone with Instructors.View can see the assignment. Last reviewed: 2026-11-18.

An instructor can be connected to a vehicle in two different ways. They mean different things, and both are set on the vehicle's form, not on the instructor's.

Connection Field on the vehicle form Meaning Effect
Current instructor (assigned vehicle) Current Instructor The instructor who normally drives this vehicle. A convenience link: narrows instructor choice when scheduling, suggests the driver in Fleet, and decides which vehicle an instructor may log kilometres for. It does not stop anyone else using the vehicle.
Owner Vehicle Ownership > Instructor Owned > Vehicle Owner The vehicle belongs to this instructor, not the school. A hard rule: only the owner may teach lessons in it. It also decides which earnings share applies.

This page covers the first. Ownership is explained in Instructor earnings and on the vehicle side in Vehicle assignment.

Rules for the current instructor

Important

  • A vehicle has at most one current instructor.
  • An instructor has at most one assigned vehicle.
  • Choosing an instructor for a vehicle moves them off any vehicle they had before, and removes whoever had this vehicle before.
  • The vehicle must be Active.
  • The instructor must work at the vehicle's branch, unless the vehicle is marked Available to all branches.

Assign a vehicle to an instructor

  1. Open OPERATIONS > Vehicles (if your plan has Fleet Management, OPERATIONS > Vehicles > Vehicles).
  2. Open the row menu of the vehicle and click Edit. (When registering a new vehicle, the same field is on the Add Vehicle form.)
  3. Scroll to Ownership & Assignment.
  4. In Current Instructor, choose the instructor. The helper text reads: "The instructor currently using this vehicle. Replaces any vehicle they were assigned before."
  5. Click Save Changes.

Screenshot to be added

Screen: Edit Vehicle dialog. Should show: Ownership & Assignment section with Current Instructor selected.

The instructor's View dialog now shows the vehicle under Assigned Vehicle as "Make Model (Registration)".

Remove or change the assignment

  • Change: edit the vehicle and choose a different Current Instructor. The previous instructor is left without a vehicle.
  • Remove: edit the vehicle, clear Current Instructor (the small cross in the field) and save.
  • Give the instructor a different vehicle: edit the other vehicle and choose them there. They are taken off the first vehicle automatically.

What the assignment is used for

Where What happens
Scheduling a lesson (the Schedule Lesson form) After you pick a vehicle, the instructor list is narrowed to the instructor assigned to that vehicle, if that instructor is free at the chosen time. If the assigned instructor is busy, or the vehicle has nobody assigned, every available instructor is listed.
Automatic vehicle choice The scheduling engine prefers a vehicle the instructor owns, then the least-used vehicle of the day. The "current instructor" link is not used here.
Fleet Management > Log kilometres The assigned instructor is pre-filled as the Driver.
Fleet Management access for instructors An instructor without Fleet.View may only log kilometres and expenses for the vehicle assigned to them and for vehicles they own. See Fleet management.
Missing kilometre logs The assigned instructor's name is shown next to a day that still needs a log.
Instructor > View Shown under Assigned Vehicle.

Note

It is not a restriction: any Active instructor at the branch who has the right licence code can be booked into a school-owned vehicle, whoever its current instructor is.

Common errors

Message Why What to do
Assigned instructor not found. The chosen instructor was deleted while the form was open. Reopen the form.
The instructor works at a different branch from this vehicle. Assign an instructor from the vehicle's branch, or make the vehicle available to all branches. Branch mismatch. Pick an instructor from the vehicle's branch, or switch on Available to all branches.
Vehicle is not active and cannot be assigned. The vehicle's status is Maintenance, Out of Service or Sold and you are assigning a new instructor. Set the vehicle to Active first, or clear Current Instructor.

Changing a vehicle's branch re-checks the rule: if the current instructor no longer matches the new branch, the save fails with the branch message above.

Example

The school's white Toyota Starlet, CA 123-456, is driven by Lerato every day.

  1. Open Vehicles > CA 123-456 > row menu > Edit.
  2. Set Current Instructor to Lerato Dlamini and click Save Changes.
  3. When reception schedules a lesson and picks CA 123-456, Lerato is the only instructor offered (if she is free). In Fleet Management, Log kilometres for that car pre-fills Lerato as the driver, and Lerato can log her own kilometres from the mobile app.

Students and lessons assigned to an instructor

DriveFlow does not have a permanent "this student belongs to this instructor" setting. An instructor's students are the students on the lessons booked with that instructor. To see them, use the instructor's calendar and the lesson reports described in Instructor performance. Booking lessons is covered in Lesson management.

Limitations and notes

  • No assignment control on the instructor's own form. The Add/Edit Instructor dialogs have no vehicle field. The API has endpoints to assign and remove a vehicle from the instructor side (PUT and DELETE /api/Instructors/{id}/assign-vehicle, permission Instructors.Edit), but no web or mobile screen calls them.
  • The vehicle's View dialog does not show the current instructor or the owner. Open Edit on the vehicle, or View on the instructor, to see it.
  • No history. Only the present assignment is stored. A table for dated assignment history (InstructorVehicleAssignment: start date, end date, primary flag) exists in the domain model but nothing reads or writes it.
  • Setting a vehicle to Out of Service does not clear its current instructor. The link stays until the vehicle is edited.
  • Deleting an instructor does not clear the link from their side in the vehicle's list of choices; edit the vehicle and choose someone else.
  • The instructor lists on the vehicle form (Vehicle Owner and Current Instructor) include instructors of every status, including Inactive ones; choosing a non-Active instructor is not blocked. The form asks for up to 1,000 instructors but the API returns at most 100 per request (ordered by instructor number), so a school with more than 100 instructor profiles will not see all of them in these lists.