Franchise
Use this page to manage Franchise Owner accounts — a special kind of staff account with its own Franchise Owner role, assigned to one or more locations.
Open the screen: Sidebar → User Management → Franchise
Franchise Owner role required
Creating a franchise owner needs a role literally named Franchise Owner to already exist. Set it up under Security → Roles first — if it's missing, Add Franchise shows "Franchise Owner" role not found. Cannot create franchise owner.
Franchise list
What it does
Shows franchise owner accounts with photo, contact details, assigned location, and status.
Step-by-step
- Open User Management → Franchise.
- Use filters to narrow the list (see table below).
- Read the table — photo, Id, Name, Type, Location, Username, Email, Phone No, Status, Actions.
- Tap refresh (circular arrow) to reload manually.
- Use pagination at the bottom to change page or rows per page.
Filters
| Filter | What it does |
|---|---|
| Name | Search by name |
| Search by email address | |
| Phone | Search by phone number |
| Location | Show All Locations or one outlet |
| Status | All, Active (default), or Inactive |
Find inactive franchise owners
The list shows Active only by default. Change Status to All or Inactive to see deactivated accounts.
What the table shows
| Column | Meaning |
|---|---|
| Photo | Profile picture or initials |
| Id | Record ID |
| Name | Full name |
| Type | Role name (Franchise Owner) |
| Location | Assigned outlet, or — |
| Username | Login username, or — |
| Email address | |
| Phone No | Country code + phone number |
| Status | Active or Inactive badge |
| Actions | Edit (pencil) only — no delete on this screen |
Common mistakes / FAQs
- "No franchise owners found". No one matches your filters — clear filters or set Status to All.
- I don't see Add Franchise or Edit. Ask your administrator for CREATE or UPDATE permission on Franchise.
Add a franchise owner
What it does
Creates a new franchise owner account with login details and location access.
Step-by-step
- Tap Add Franchise.
- On Franchise Details, enter Full Name, Email, Country Code, and Phone Number (9–10 digits, numbers only).
- Enter a Password (required for new accounts).
- Optionally enter 4-Digit Passcode, Max Working Hours (defaults to 8), and Base Wage (Per Hour).
- Toggle Active on or off (defaults on).
- Under Location assignment, select one or more Locations / Restaurants.
- Choose how to save:
- Tap Submit to create the account immediately.
- Tap Next to open Profile Picture, upload a photo, then tap Complete.
- On success: Franchise owner created successfully.
Username is created for you
You do not type a username when adding a franchise owner — the system assigns one automatically.
Common mistakes / FAQs
- "Please enter a valid email address". Enter a full email with @ and domain.
- "Phone number must be 9-10 digits long and contain only numbers". Enter digits only, 9 or 10 long.
- "Passcode must be exactly 4 digits". Enter four numbers, or leave it blank.
- "Role Not Available". The Franchise Owner role doesn't exist yet — create it under Security → Roles.
Profile picture
What it does
Upload or change the franchise owner's photo, shown in the table and on their account.
Step-by-step
- In the dialog, tap the Profile Picture tab.
- Upload an image (drag-and-drop or click to browse) — accepted as any image file, up to the site's size limit.
- Crop the image if prompted, then confirm.
- Tap Complete to save the photo along with any unsaved details.
- Tap Back to return to Franchise Details without leaving the dialog.
To replace or remove an existing photo, hover it and use Change Image or Delete.
Deleting a photo cannot be undone
Confirm Delete Image only if you're sure — there is no undo.
Edit a franchise owner
What it does
Updates an existing franchise owner's details, locations, password, or photo.
Step-by-step
- Tap Edit (pencil) on a row.
- On Franchise Details, change the fields you need. Username is shown but cannot be changed.
- Password — leave blank to keep the current password; enter a new value only to change it.
- 4-Digit Passcode — leave blank to keep the current passcode.
- Update Locations / Restaurants if needed.
- Tap Submit to save, or Next → Profile Picture → Complete to also update the photo.
- Tap Reset to undo unsaved changes.
Common mistakes / FAQs
I saved but nothing seems to have changed. Why?
If none of the fields were actually different from before, saving shows No changes detected in franchise details instead of an update — this is expected, not an error.
Deactivate a franchise owner
🔒 Manager only - tap Edit, toggle Active off, then tap Submit to stop someone signing in without deleting their record.
Do not share logins when someone leaves
Deactivate the account instead of handing their login to a replacement.
Permissions
| What you need | Why |
|---|---|
| Franchise module permission | See the Franchise menu and list |
| CREATE on Franchise | Tap Add Franchise |
| UPDATE on Franchise | Tap Edit (pencil) |