Branch management¶
Applies to: Owner, Administrator (and any custom role with the Company and Branches permissions). Last reviewed: 2026-11-18.
A branch is one location of the school. Every school has a Main Branch, created at registration. Branches decide which records a user sees and which instructors and vehicles can be used for a lesson.
Who can do this¶
| Action | Permission | Built-in roles that have it by default |
|---|---|---|
| Open the page that lists branches (Settings > Organisation) | View Company (Company.View) |
Owner, Administrator |
| See the branch list | View Branches (Branches.View) |
Owner, Administrator, Manager |
| Add a branch | Create Branches (Branches.Create) |
Owner, Administrator |
| Edit, disable or enable a branch | Edit Branches (Branches.Edit) |
Owner, Administrator |
The Manager role has View Branches but not View Company, so with the default permissions a Manager cannot reach the branch list on screen.
Your plan must allow another branch
Adding a branch also depends on the school's subscription plan (the Multi Branch feature and its limit). If the plan does not allow another branch the server refuses the request; see the subscription documentation.
Where branches are¶
- In the left menu click Settings.
- Click the Organisation card.
- Scroll to the Branches card at the bottom ("Add, edit and disable your branches").
Screenshot to be added
Screen: Organisation page. Should show: the Branches card with the branch table and the Add Branch button.
The table shows Code, Name (with a Main chip on the main branch), Manager, Location (city, province), Status (Active or Disabled) and Actions.
Add a branch¶
- In the Branches card click Add Branch.
-
Fill in the dialog:
Field Required Notes Branch code Yes A short code, at most 20 characters, unique within the school (for example PTA).Branch name Yes At most 150 characters. Manager name No Free text; it is not linked to a user. Email Yes Must be a valid email address. Phone number Yes Address line 1 No Address line 2 No City Yes Province Yes Postal code No Opening time - Defaults to 08:00. Closing time - Defaults to 17:00. Must be after the opening time. -
Click Create Branch.
- You see Branch created successfully. and the branch appears in the table as Active.
What is created with it: the branch's own scheduling settings and working hours, with the same defaults as a new school's main branch (60-minute lessons, 30-minute slots, Monday-Friday 08:00-17:00, Saturday 08:00-13:00, Sunday closed, and so on). Change them under Settings > Scheduling.
Example¶
A school in Johannesburg opens in Pretoria. The owner clicks Add Branch and enters code PTA, name Pretoria, manager Sipho Dlamini, email pretoria@rosebankdriving.example, phone 012 555 0100, city Pretoria, province Gauteng, and leaves the times at 08:00 and 17:00. After Create Branch she adds the Pretoria instructors and vehicles with that branch, creates the Pretoria receptionist with Branch = Pretoria, and sets her own user to All branches.
Edit a branch¶
- In the branch's row click the pencil icon (Edit branch).
- Change the fields (the same as when adding).
- Click Save Changes. You see Branch updated successfully.
Disable or enable a branch¶
To disable:
- In the branch's row click the block icon (Disable branch).
- Confirm Disable (name)? It will no longer be available for scheduling.
- You see Branch disabled. and the status becomes Disabled.
To enable again, click the tick icon (Enable branch). You see Branch enabled. There is no confirmation.
Effects of disabling:
- Lessons cannot be scheduled at the branch ("Branch is not active.").
- The branch is no longer offered when choosing a branch for a user ("The selected branch is not available." if it is sent anyway).
- Its existing records are kept.
Note
The main branch cannot be disabled: its block icon is greyed out, and the server answers "The main branch cannot be disabled."
What a branch controls¶
What a user sees¶
Each user has a Branch field (see User management):
- A specific branch: the user only sees that branch's records.
- All branches (field left empty): the user sees the whole school.
The records filtered by branch are: students, instructors, vehicles, lessons, lesson requests (bookings), quotes, invoices, payments, instructor reviews, instructor earnings, and fleet kilometre logs and expenses. Records that belong to the school as a whole, such as training packages, are not filtered by branch.
A user tied to one branch cannot work in another: scheduling answers "You do not have access to this branch."
What a lesson can use¶
A lesson belongs to a branch. Its instructor and its vehicle must belong to the same branch ("The instructor belongs to a different branch.", "The vehicle belongs to a different branch."), and a student's course must be at that branch ("The selected course belongs to a different branch.").
Scheduling settings¶
Working hours and booking rules are kept per branch. See the scheduling settings documentation.
Switching between branches¶
There is no branch switcher in the application. The branch name shown at the top of the left menu is only a label: your own branch, or the main branch if you have All branches. The arrow beside it does nothing.
To work with another branch's data, a user must either be set to All branches or have their Branch changed by someone with the Edit Users permission. Changing a user's branch signs that user out; they sign in again to continue.
The Owner is tied to Main Branch at registration
A school with more than one branch should set the Owner (and anyone else who manages the whole school) to All branches. Otherwise they only see Main Branch's records.
To set your own user to All branches:
- Settings > Users & Access.
- On your own row click ⋮ then Edit.
- Clear the Branch field so it reads All branches.
- Click Save Changes, then sign in again.
Messages you may see¶
| Message | Why |
|---|---|
| Branch code is required. / Branch name is required. / Email is required. / Phone number is required. / City is required. / Province is required. | A required field is empty. |
| Closing time must be after the opening time. | The times are the wrong way round or equal. |
| Branch code 'X' already exists. | Another branch of your school uses that code. |
| Branch was not found. / Branch could not be found. | The branch does not exist or belongs to another school. |
| The main branch cannot be disabled. | |
| Unable to create branch. / Unable to update branch. / Unable to enable branch. / Unable to disable branch. | The request failed. This is also what you may see when the plan's branch limit is reached, if the server's reason cannot be shown. |
| Failed to load branches: ... | The list could not be read, for example because you lack View Branches. |
Limitations and notes¶
- Branches cannot be deleted. A Delete Branches permission exists and is given to the Owner and Administrator, but there is no delete button and no delete operation on the server. Use Disable.
- The main branch cannot be changed. No screen moves the Main flag to another branch.
- No branch switcher, as described above.
- Manager name is plain text. There is no "Branch Administrator" or "Branch Manager" role; a person manages a branch simply by being a user tied to it with a suitable role.
- The server stores a latitude and longitude for a branch, but the dialog has no fields for them.
- The exact wording shown when the plan's branch limit is reached was not verified.
- Disabling a branch does not disable or move its users, instructors, vehicles or students; do that yourself if the branch is closing.
Related articles¶
- User management - set each user's branch.
- Company profile - the Organisation page that holds the Branches card.
- Scheduling settings - working hours and booking rules per branch.
- Feature access - plan limits on branches.
- First-time setup - setting up a school with more than one location.