Skip to content

Registering a vehicle

Applies to: Owner, Administrator (any role with the Vehicles.Create permission). Last reviewed: 2026-11-18.

Every lesson and driving test in DriveFlow is booked in a vehicle. This page explains how to add a vehicle and what each field on the form means.

Who can do this

Action Permission Default roles
Open the Vehicles page Vehicles.View Owner, Administrator, Manager, Instructor, Receptionist, Finance, Viewer
Add a vehicle Vehicles.Create Owner, Administrator

Important

The Add Vehicle button is drawn only for users with Vehicles.Create. Your plan must include Vehicle Management, and it sets how many vehicles you may have (see Plan limit).

Before you start

  • At least one branch must exist.
  • At least one licence code must be set up for your school.
  • If the vehicle belongs to an instructor, that instructor must be registered first (Registering an instructor).

Steps

  1. In the left menu under OPERATIONS, click Vehicles. If your plan has Fleet Management the menu is a group: click Vehicles, then Vehicles.
  2. Click Add Vehicle (top right of the table).
  3. Fill in the form sections described below.
  4. Click Save Vehicle.

You see "Vehicle added successfully.", the dialog closes, and the table and summary cards refresh.

Screenshot to be added

Screen: Add Vehicle dialog. Should show: Vehicle Information section filled in.

Screenshot to be added

Screen: Add Vehicle dialog. Should show: Ownership & Assignment, Documents & Expiry and Licence Codes sections.

The form, field by field

Vehicle Information

Field Required What it means
Registration Number Yes The number plate, for example "ABC 123 GP". Up to 20 characters. Must be unique among your school's vehicles. This is what staff see in vehicle pickers when scheduling.
VIN No Vehicle identification (chassis) number. Up to 30 characters.
Engine Number No Up to 30 characters.
Make Yes For example "Toyota". Up to 50 characters.
Model Yes For example "Corolla". Up to 50 characters.
Year Yes in practice Year of manufacture. Must be between 1950 and next year. The field starts at 0, so you must enter it.
Colour No Up to 30 characters.
Transmission Yes Manual (default) or Automatic. Shown on the list and in reports. It is information only: scheduling does not match transmission to the student.
Fuel Type Yes Petrol (default), Diesel, Hybrid or Electric.
Branch Yes The vehicle's home branch. It decides the vehicle number, which branch's reports include the vehicle, and where it can be booked. When "Available to all branches" is on, the label changes to Home Branch.
Available to all branches No Switch on to let every branch of your school book this vehicle. The form then notes: "Can be booked at every branch. The home branch is used for the vehicle number and reports."
Current Mileage No (defaults to 0) The odometer reading in km today. Must not be negative. It is compared with the next service mileage, and Fleet Management moves it forward as kilometres are logged.
Status Shown, but ignored when adding A new vehicle is always saved as Active whatever is chosen here. Change the status afterwards with Edit; see Vehicle information.

Ownership & Assignment

Field Required What it means
Vehicle Ownership Yes School Owned ("Vehicle belongs to the driving school", default) or Instructor Owned ("Vehicle belongs to an instructor"). Click one of the two cards.
Vehicle Owner Yes when Instructor Owned The instructor who owns the vehicle. Appears only when Instructor Owned is selected. Only this instructor may teach lessons in the vehicle.
Current Instructor No The instructor who normally uses the vehicle. Helper text: "The instructor currently using this vehicle. Replaces any vehicle they were assigned before."

These two instructor fields do different things; see Vehicle assignment.

Purchase Information

Field Required What it means
Purchase Date No When the vehicle was bought.
Purchase Price No In rand; must not be negative. Recorded for reference only; it is not used in any calculation, including fleet profit.

Documents & Expiry

Field Required What it means
Insurance Expiry No The day the insurance cover ends.
Roadworthy Expiry No The day the roadworthy certificate ends.
Licence Disc Expiry No The day the licence disc expires.
Next Service Date No "Optional - you'll be notified when it's due".
Next Service Mileage No In km. "Optional - compared with the current mileage".

All five are optional, and each one you fill in switches on a reminder in the notification bell. See Vehicle maintenance.

Notes

Free text, up to 1,000 characters ("Additional vehicle information...").

Licence Codes

"Select all licence codes this vehicle can be used for." Click the circle in the Use column for each code; a selected code shows a green tick. At least one is required.

A lesson for a licence code can only be booked in a vehicle that has that code.

What happens when you save

  • The vehicle gets a vehicle number built from the home branch's code, the letters VEH and the next number in that branch's sequence (for example JHB-VEH-0003).
  • Its status is Active.
  • If a Current Instructor was chosen, that instructor's assigned vehicle becomes this one (and they are removed from any vehicle they had).
  • The vehicle and the instructor assignment are saved together: if the assignment is not allowed, nothing is saved.

Plan limit

Before saving, DriveFlow counts your vehicles whose status is not Sold (deleted vehicles do not count). At the limit, nothing is saved and you see:

Your {plan name} plan allows up to {limit} vehicles. Upgrade your plan to add more.

The limits seeded with the product are 2 on the Free Trial, 5 on Starter, 15 on Professional, 30 on Enterprise, 70 on Enterprise Plus and unlimited on Enterprise Custom. See Subscriptions and billing.

Common errors

Message Why What to do
Registration number is required. / Make is required. / Model is required. Required field empty. Fill it in.
Please select a branch. No branch chosen. Choose a branch.
Please select at least one licence code. No licence code ticked. Tick at least one.
Please select the vehicle owner. / Please select the instructor who owns this vehicle. Instructor Owned without an owner. Choose the Vehicle Owner.
Registration Number already exists. Another vehicle of your school (not deleted) has this registration. Check the number; edit the existing vehicle instead.
Branch not found. The branch was removed or is outside your access. Reopen the form.
Licence Code '…' not found. A ticked code was removed meanwhile. Reopen the form.
Assigned instructor not found. The chosen Current Instructor was deleted. 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. Current Instructor is at another branch. Choose another instructor or switch on Available to all branches.
Your … plan allows up to … vehicles. Upgrade your plan to add more. Plan limit. Mark an old vehicle as Sold, or upgrade.
Unable to add vehicle. / Unable to register vehicle. The server rejected the request without a specific message, most often a Year outside 1950 to next year. Check the Year and the field lengths.
Unable to load vehicle options: … The branch, licence code or instructor lists could not be loaded. Close and reopen the dialog.

Example

The school buys a white 2024 Suzuki Swift for the Pretoria branch, to be used for Code 08 lessons by instructor Naledi.

  1. Open OPERATIONS > Vehicles > Add Vehicle.
  2. Registration Number JK 45 LM GP; Make Suzuki; Model Swift; Year 2024; Colour White; Transmission Manual; Fuel Type Petrol.
  3. Branch Pretoria; Current Mileage 12 500.
  4. Vehicle Ownership School Owned; Current Instructor Naledi Khumalo.
  5. Insurance Expiry 31 Oct 2027; Roadworthy Expiry 15 Mar 2027; Licence Disc Expiry 30 Apr 2027; Next Service Mileage 25 000.
  6. Tick the Code 08 licence code and click Save Vehicle.

The vehicle appears as Active with the next Pretoria vehicle number, and can be chosen when scheduling Code 08 lessons at Pretoria.

Limitations and notes

  • The Status field on the Add form has no effect; the vehicle is always created Active.
  • Year must be typed. It starts at 0 and the server rejects values outside 1950 to next year; the form's own upper limit of 2100 is looser than the server's.
  • No document uploads. You can record expiry dates but cannot attach the licence disc, roadworthy certificate or insurance schedule. (Fuel and expense receipts can be attached in Fleet management.)
  • No vehicle photo, seat count, tracker or dual-control fields.
  • Registration uniqueness is exact text. "ABC123GP" and "ABC 123 GP" are treated as different, so agree on one way of writing plates.
  • Licence category of the vehicle is expressed only through the licence codes ticked; there is no separate vehicle class field.
  • The Vehicle Owner and Current Instructor lists include instructors of every status and show at most 100 instructors.

Tip

Agree on one way of writing number plates (for example always with spaces), because registration uniqueness is checked on the exact text.