If your account is assigned to only one branch, the app loads that branch automatically and no picker is shown.
How the branch picker works
There are two ways the branch picker appears:- On first login (initial mode): when you sign in and no branch session is cached, the app shows a full-screen branch list. You cannot go back or access any other part of the app until you pick a branch.
- Mid-session (switch mode): you can open the picker at any time from Settings → Switch branch. A back arrow is shown so you can cancel and return to what you were doing.
Picking a branch on first login
Sign in to the app
Enter your email and password on the login screen. After a successful login, if you are assigned to more than one branch and no branch is cached, the branch picker opens automatically.
Tap the branch you want to work in
A loading indicator appears next to the branch name while the app connects. The app loads your permissions, settings, menu, and printer configuration for that branch.
Switching branches mid-session
Tap Switch branch
Select Switch branch from the settings list. The branch picker opens with a back arrow so you can cancel if needed.
Check for an open shift
If you have an open shift on your current branch, the app shows a warning. Leaving without closing the shift does not close it on the server — shift-restricted actions on the new branch will be unavailable until you return and close it properly. Tap Switch branch to proceed anyway, or tap Cancel to go back and close the shift first.
What happens when you switch
Switching branches does not sign you out. Your login session stays active. However, the app fully clears everything tied to the previous branch before loading the new one: Cleared from the device:- Open orders and KOT tickets
- Menu categories and items
- Tables and their live status
- Active cart and any items in progress
- Print job queue (both cloud and locally queued jobs)
- Printer configuration and reach settings
- Shift state, reservations, attendance session, notifications, and app settings cache
- Your role permissions for that branch
- Branch settings (including printer configuration and whether QSR mode is on)
- Realtime connections — order, table, and KOT channels reconnect to the new branch, and the print job stream re-binds to the new branch’s printer setup