Roles, navigation and switchers
How to sign in, what each role sees in the sidebar, and how the clinic switcher, store switcher and Quick Create work on desktop and mobile.
This page shows you how to get around LeapHealthOS: signing in, the profile menu, the sidebar, the top bar and the mobile layout. It also explains why two people can see different menus.
Signing in
- Open your LeapHealthOS address. You are taken to the sign-in page.
- Enter your Email and Password and select Login. Tick Remember me if you want this device to remember your sign-in details.
- You land on the dashboard.
If your organisation uses single sign-on, you sign in with your organisation's sign-in page instead, and return to LeapHealthOS afterwards.
Forgot your password
Select Forgot password? on the sign-in page and follow the steps on screen to choose a new password. If you are not sure what to enter, ask your administrator.
An administrator can also reset your password from SettingsClinic & Doctor SetupUsers with Reset Password.
When you are signed out
If your session ends, you are taken back to the sign-in page. Sign in again to continue.
Your profile menu
Select your name at the bottom of the sidebar to open the profile menu. It shows:
Item | What it does |
|---|---|
Name and email | Who you are signed in as. |
Profile | Opens your organisation's business profile and compliance details. |
WhatsApp number and Copy your invite link | Your clinic's WhatsApp number. The invite link opens a WhatsApp chat with that number with "Hi" already typed. Share it with patients so they can message you, for example to reach your WhatsApp booking assistant. |
Go Online | Marks you as available. The dot on your avatar turns green when you are online. |
Logout | Signs you out. |
Why menus differ between people
Two things decide what you see:
- Your staff type (your role, such as Doctor or Nurse). The sidebar shows each clinical workspace to the matching role.
- Your permissions. Your administrator decides what each staff type may do. Some menus, and many buttons inside screens, appear only for people who are allowed to use them. See Roles and permissions.
In this page, admin means a person whose staff type has the Configure permission on Org, such as the starter Tenant Admin role, or the administrator account your organisation was created with. Admins see every menu.
The sidebar by role
This table shows the desktop sidebar for each role when the person is not an admin. Admins see everything.
Menu | Doctor | Nurse | Counsellor | Pharmacist | Lab staff | Receptionist | Other non-clinical staff |
|---|---|---|---|---|---|---|---|
Home | Yes | Yes | Yes | Yes | Yes | No | Yes |
Consultations | Yes | No | No | No | No | No | No |
Care Station | No | Yes | No | No | No | No | No |
Counselling | No | No | Yes | No | No | No | No |
Test | No | No | No | No | Yes | No | No |
Pharmacy | No | No | No | Yes | No | No | No |
Alerts | No | Yes | No | Yes | Yes | Yes | Yes |
All Patients | Yes | No | No | Yes | Yes | Yes | Yes |
All Appointments | No | No | Yes | No | No | Yes | Yes |
Payment | No | No | No | No | No | Yes | Yes |
Tasks | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
Journeys | If allowed | If allowed | If allowed | If allowed | If allowed | If allowed | If allowed |
Settings | No | No | No | No | No | No | No |
- The role columns go by the staff type's Code (shown in the Staff types section of the Organisation tab): Doctor is
DOCTOR, NurseNURSE, CounsellorCOUNSELLOR, PharmacistPHARMACIST, and ReceptionistRECEPTIONIST. - Lab staff means the codes
LAB_TECHNICIAN,RADIOLOGISTandPATHOLOGIST. - Other non-clinical staff means the codes
CALL_CENTRE,HR,CASHIER,ACCOUNTS,OPERATIONS,HOUSEKEEPING,SECURITY,INVENTORY,IT_SUPPORT,DRIVERandOTHERS. - A staff type with any other code sees Home, All Appointments, Tasks and, if allowed, Journeys.
- Journeys appears for people who are allowed to view journeys. See Who can do what in Journeys.
- The Alerts item shows a badge with the number of alerts that are firing.
Starter roles and the sidebar
The starter staff types Front Desk (FRONT_DESK), Lab (LAB), Pharmacy (PHARMACY) and Centre Admin (CENTRE_ADMIN) do not match the codes above, so people who carry them see only Home, All Appointments, Tasks and, if allowed, Journeys. If your front desk, lab or pharmacy staff need their workspaces, create staff types with the codes listed above, give them the starter type as a parent so they inherit its permissions, and assign those types to the staff. See Roles and permissions.
The Settings group
Admins see Settings. It has these parts:
Item | Contains |
|---|---|
Clinic & Doctor Setup | Users, Clinic Configuration, Doctor Configuration |
Platform Configuration | System Settings, Payers & tariffs, PDF Templates, Verification, Notification Rules, Alert Rules, Service Catalog, Packages, Tenant Registry, Document Requirements, Config History |
Inventory Settings | Store setup for pharmacy and general stores |
Inventory | Pharmacy, General Store |
On smaller screens, the sidebar collapses to icons.
The top bar
The bar across the top of most screens shows the page title and, depending on the screen, a switcher and the Quick Create button.
Clinic switcher
The clinic switcher (placeholder Select Clinic) lists your organisation's active centres. The first time you use LeapHealthOS on a device, the first clinic in the list is selected for you; after that, the device remembers your last choice. The clinic you pick decides what you see in lists such as All Patients, which shows the patients registered at that clinic.
Can't find a patient or appointment?
Check the clinic switcher first. Lists show the selected clinic only, so a patient registered at another centre does not appear until you switch to that centre.
The clinic switcher is not shown on most Settings screens or in Journeys. Settings screens that need a centre have their own picker.
Store switcher
On the Pharmacy workspace and the Inventory screens, a store switcher (placeholder Select Store) replaces the clinic switcher. Pick the pharmacy or general store you are working in. See Stores and store roles.
Quick Create
Quick Create starts the most common front-desk jobs from the top bar of most screens outside Settings:
Option | What happens |
|---|---|
New Patient | Opens Quick Add Patient. You enter a mobile number; LeapHealthOS shows any patients already registered under it, or lets you register a new one with your organisation's registration form. You then choose Book Appointment or Create Bill. See Finding and registering patients. |
New Appointment | Starts the booking flow from the patient's phone number. See Booking an appointment. |
New Payment | Starts creating a payment for a patient. See Creating a payment and collecting money. |
Where the top bar is hidden
Patient workspaces use the full screen, so the top bar is hidden on consultation, Care Station, counselling, pharmacy and test detail screens, on the patient profile, on PDF Templates and during onboarding wizards. Booking and payment flow screens show a back arrow instead of the switcher.
There is no global search. Search boxes sit inside the lists that use them, such as All Patients, All Appointments and Payment.
Home
Home is not available yet. It shows a preview behind a "coming soon" overlay, and the figures in it are sample data. Start your day from your role's worklist instead: Consultations for doctors, Care Station for nurses, All Appointments for front desk, and Tasks for everyone.
Using LeapHealthOS on a phone
On a phone, a bottom navigation bar replaces the sidebar. It follows the same role rules, with these differences:
- Home, Alerts and Settings are not in the bottom bar.
- All Patients is labelled Patients.
- The top bar shows the page title and Quick Create. There is no clinic switcher on a phone: lists use the clinic last selected on that device, or the first clinic if none was chosen.
View as (admins on mobile)
Because admins can see every menu, the mobile bar would be crowded. Administrators get a View as row above the bottom bar with the chips Doctor, Nurse, Counsellor, Pharmacist, Lab and Reception. The chip you pick limits the bottom bar to that role's items, plus Tasks:
View as | Bottom bar items |
|---|---|
Doctor | Consultations, Patients, All Appointments, Payment, Tasks |
Nurse | Care Station, All Appointments, Tasks |
Counsellor | Counselling, Patients, All Appointments, Tasks |
Pharmacist | Pharmacy, Patients, All Appointments, Tasks |
Lab | Test, Patients, All Appointments, Tasks |
Reception | Patients, All Appointments, Payment, Tasks |
The view starts on Doctor and remembers your last choice on that device. It changes only what is in the menu, not what you are allowed to do.
If something goes wrong
If a screen fails to load, you see Something went Wrong!! with the error message and buttons to try again or reload the page. Reload first. If the error keeps appearing, note the message and the screen you were on and contact your administrator.
Related pages
Last updated on
Key concepts and glossary
Plain-language definitions of the terms used across LeapHealthOS, from centres and staff types to visit types, placements, journeys and stores.
First-time setup checklist
The order to set up a new LeapHealthOS organisation, from the tenant registry and centres to staff, doctors, services, forms, settings and journeys.