Branch selector
The header dropdown that filters data by branch โ how it persists, single vs multi-select.
Overview
The branch selector lives in the page header on most pages and controls which branch (or branches) the current page is looking at. It persists per page, survives refresh, and has two variants: single-select and multi-select.
When to use it
- Narrowing analytics, sales, or inventory to one specific branch
- Comparing two or three branches side-by-side (multi-select pages)
- Switching a staff workstation to its "home" branch
How to use it
Video tutorial coming soon
- Click the branch selector in the page header.
- Pick one or multiple branches (depending on page):
- Single-select: Inventory tabs, Staff, some branch pages โ you work in one branch at a time.
- Multi-select: Home, Analytics, Sales, Reports, Products, Promotions โ compare across branches.
- Your selection persists in localStorage and is reloaded next time you visit the page.
Single vs multi-select
| Page family | Variant | Why |
|---|---|---|
| Home | Multi | Org-wide overview; useful to compare |
| Analytics | Multi | Cross-branch comparisons |
| Sales | Multi | Compare bills / products / categories across branches |
| Products | Multi | Catalog often spans branches |
| Promotions | Multi | Same promo can target multiple branches |
| Reports | Multi | Generate across multiple branches in one report |
| Inventory | Single | Stock actions apply to one branch at a time |
| Cash Drawers | Single | Devices belong to one branch |
| Prescriptions | Single | Prescriptions live at a single branch |
| Staff | Single | Staff are branch-scoped |
Tips & gotchas
- Persistence keys are per page (e.g.,
home-branches-select,sales-branches-select) โ changing selection on Home doesn't affect Sales. - STAFF users typically default to their assigned branch and can't see "All Branches".
- If no branches are selected on a multi-select page, Klu falls back to all branches.
- Some pages (like Products editing) swap forms based on selection โ "All Branches" uses the org-wide form, a single branch swaps to the branch-specific form.