Skip to content

Licence Codes

Applies to: roles with Settings.View (view) and Settings.Manage (switch codes on and off). Last reviewed: 2026-11-18.

A licence code is the class of driving licence a student trains for, for example Code B. This page explains where licence codes come from, how a school chooses which ones it offers, and what that choice affects.


1. Key facts

  • Licence codes are defined by DriveFlow, per country. A school cannot create, rename or delete a licence code. There is no screen for that, for schools or for the SuperAdmin.
  • A school chooses which of its country's codes it offers by switching each one on or off.
  • When a new school is registered, every active licence code of its country is added and switched on.

2. Licence codes that come with the system

These are created by the system itself (database seed data and a start-up seeder).

South Africa

Code Name shown Description Minimum age
A1 Motorcycle (≤125cc) Motorcycles with an engine capacity not exceeding 125cc. 16
A Code A Motorcycle licence 18
B Code B Light motor vehicle licence 18
EB Code EB Light motor vehicle with trailer licence 18
C1 Code C1 Medium/heavy motor vehicle licence up to 16 000 kg 18
C Heavy Motor Vehicle Motor vehicles with a gross vehicle mass (GVM) exceeding 16 000 kg. 18
EC1 Heavy Vehicle with Trailer (EC1) Combination of vehicles where the drawing vehicle falls within Code C1. 18
EC Code EC Extra heavy articulated vehicle licence 18

Zimbabwe

Code Name shown Description Minimum age
Class 1 Class 1 Motorcycle licence 16
Class 2 Class 2 Light motor vehicle licence 18
Class 4 Class 4 Heavy vehicle licence 20

The two styles of name for South Africa ("Code B" versus "Heavy Motor Vehicle") come from the two places the codes are created in; they are shown exactly as stored.

Note

Each code also carries a minimum age, a requires learner's licence flag and a requires professional driving permit flag. These three values are stored but not used by any rule and not shown on screen (see Limitations).


3. Viewing your licence codes

Who: users with Settings.View.

  1. In the left menu, under ADMINISTRATION, click Settings.
  2. Open Driving School.
  3. On the Licence Codes card, click Manage Licence Codes.

The Licence Codes page opens (/settings/driving-school/licence-codes) - "Select the licence codes your driving school offers."

Screenshot to be added

Screen: Licence Codes page. Should show: cards for each code with their switches, some marked "Offered by school" and some "Not offered".

Each code is a card showing:

  • the code (large badge), name and description;
  • a switch;
  • a chip: Offered by school or Not offered;
  • a footer line: "Licence available for students" or "Licence currently disabled".

Codes are listed in code order. Only your country's codes that you have a record for are shown.


4. Switching a licence code on or off

Who: users with Settings.Manage. Without it the switches are greyed out.

  1. Open the Licence Codes page.
  2. Click the switch on the code's card.
  3. You see "(code) enabled." or "(code) disabled." The change is saved immediately; there is no Save button.

If it fails you see "Unable to update licence code."

What switching a code off does

Area Effect
Register Student > Licence Code list The code is no longer listed.
Start New Course > Licence Code list The code is no longer listed.
Add / Edit Training Package > Licence Code list The code is no longer listed. Saving a package with it is refused: "The selected licence code is not available for this driving school."
Existing packages for that code They are kept, still show on the Training Packages page, but can no longer be reached when registering a student or starting a course from scratch (those screens list packages by licence code).
Existing students and courses Not affected. Students already on that code keep it, and their lessons continue.

Note

Switching a code off does not affect students and courses already on that code. Switching a code back on restores all of the above.


5. Where licence codes are used

Used for Details
Training packages Every Training-type package belongs to one licence code. Assessment-type packages have none. See Training packages.
Students and courses A student and each of their courses record the licence code being trained for. See Courses.
Instructors and vehicles Instructors and vehicles are also linked to licence codes, which matters when scheduling. See Instructor profiles, Vehicle information and Availability and conflicts.
Automatic package codes A new package's internal code starts with the licence code, for example B-3. See Training packages.

6. Example

A school in Johannesburg only teaches Code B and Code EB.

  1. An administrator opens Settings > Driving School > Manage Licence Codes.
  2. They switch off A1, A, C1, C, EC1 and EC, leaving B and EB on.
  3. From now on, reception only sees Code B and Code EB in the Licence Code list when registering a student.

7. Limitations and notes

  • Schools cannot add their own licence codes. If a school needs a code that is not listed, it has to be added to the system by a developer. No management screen exists.
  • Codes added to the system later do not appear automatically for existing schools. A school only sees the codes it was given a record for when it was registered. A code added to the system afterwards is given to new schools only; existing schools need a data fix.
  • Minimum age is not enforced. A student's age is never checked against the licence code's minimum age. The only age rule is the general "older than 16" rule at registration.
  • "Requires learner's licence" and "requires PDP" are not enforced. Lesson booking has its own learner's licence rule that applies to every code (see Student training information). The student's PDP is never checked.
  • Only South Africa and Zimbabwe have licence codes. Registering a school in a country with no active licence codes fails.
  • The API endpoint behind the lists on other screens (GET api/LicenceCodes) only needs a signed-in user; the management endpoints (api/driving-school/licence-codes) need Settings.View and Settings.Manage.