> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ofatoura.com/llms.txt
> Use this file to discover all available pages before exploring further.
# ePOS App Settings and Manager Overrides
> Configure the oFatoura waiter app to match your workflow — theme, language, app lock, payment defaults, QSR mode — and learn how the manager override PIN gate works for sensitive actions.
The Settings screen in the ePOS waiter app lets each staff member personalise their experience on the device and control security behaviour. Managers and supervisors also have access to an override PIN gate that protects sensitive operations like editing another waiter's order or accepting a shift variance.
All settings are stored per user and per device. Changing settings on one device or signing in as a different user will not affect other devices or other staff members.
## Opening Settings
Tap the menu icon in the app bar (or open the left-hand drawer) and choose **Settings**. All configuration options are grouped on a single screen.
***
## Appearance and language
Under **Theme**, select **Light**, **Dark**, or **System** (follows your device's system-level setting).
Under **Language**, select **English** or **Omani Arabic**. The change takes effect immediately across the entire app.
***
## App lock and Quick PIN
The app can automatically lock the screen after a period of inactivity, requiring a PIN to resume. This protects the till if a device is left unattended.
### Setting the auto-lock timeout
In Settings, tap **App lock timeout** and choose one of:
| Option | Locks after… |
| ---------- | ---------------------------------- |
| Immediate | Every time the app is backgrounded |
| 30 seconds | 30 s of idle or backgrounding |
| 1 minute | 1 min |
| 5 minutes | 5 min |
| 15 minutes | 15 min |
### Setting up your Quick PIN
The Quick PIN itself is configured in the **web admin**, not on the device. In Settings, tap **Set Quick PIN** — this redirects you to the web admin security page where you create or change your 4–8 digit numeric PIN.
Once set, you and your colleagues can unlock the screen (or switch users without a full log-out) using the PIN keypad. If no PIN has been set, the app falls back to your password.
Quick PINs work even without an internet connection — the app stores a secure copy on the device so you are never locked out offline.
The lock state is per device. Locking the app on one tablet does not lock other devices.
***
## Default payment method
Under **Default payment method**, choose the method that is pre-selected when you open the payment screen: **Cash**, **Card**, or **Other**. You can always change it at checkout time.
***
## QSR mode
**QSR mode** simplifies the ordering flow for quick-service restaurants where speed is more important than table management. Toggle it on in Settings when your branch has QSR mode enabled. Contact your manager or check the web admin under order type settings if you are unsure whether your branch supports this.
QSR mode availability depends on how your branch is configured in the web admin. If the toggle has no effect, ask your administrator to enable QSR mode for the branch first.
***
## One-click buttons
When **One-click buttons** is turned on, the app shows your most-used or memorised items as large tap targets on the order screen, reducing the number of steps to add a frequent item. Toggle this on or off in Settings to suit your preference.
***
## Change password
Scroll to **Change password** in Settings and follow the prompts to update your account password. This affects your full login across all devices.
***
## Branch and terminal info
The Settings screen shows a read-only **Branch / Terminal info** panel with:
* The branch you are currently signed into
* The POS terminal this device is paired to (if pairing has been done)
* App and API version numbers
To pair or re-pair a terminal, see [Pairing the Device to a POS Terminal](/epos-app/terminal-pairing).
***
## Developer options
A **Developer options** section is available at the bottom of Settings. The main toggle here is:
* **Disable printing from this device** — turns off all local print jobs originating from this tablet/phone. Useful for troubleshooting or for devices that are used purely for order entry and should not trigger printing.
Enabling "Disable printing from this device" will stop all receipt and KOT printing from this device until you turn it off again. Only use it intentionally or when directed by your administrator.
***
## Manager overrides for sensitive actions
Some actions in the app require a manager or supervisor to authorise the operation with their PIN before it can proceed. This is called the **manager override gate**.
### When a manager override is required
| Action | Triggered when… |
| ---------------------------------- | ------------------------------------------------------------------------- |
| Edit another waiter's locked order | You try to modify an order that belongs to a different waiter |
| Accept a shift variance | You close a shift and the counted cash does not match the expected amount |
| Mark an order as tax exempt | You tap the tax exempt toggle on an active order |
| Void an order or item | You attempt to void after an order has already been sent to the kitchen |
### How the override flow works
Tap the button or option that requires authorisation (for example, editing a locked order or accepting a variance on shift close). The app immediately shows the manager override modal.
A manager or supervisor enters their Quick PIN on the numeric keypad. The app sends this to the server for validation.
If the PIN is valid and the manager has the right permission for that specific action, the server returns a short-lived authorisation token scoped to that action.
The original operation completes automatically using the token. The token is valid for **60 seconds** and can only be used once for that specific action. If nothing happens within 60 seconds, you will need to request authorisation again.
The override token is scoped to one action only. A manager PIN entered to approve a tax-exempt action cannot be reused to approve a void or a variance on the same shift.
If the manager is not physically present, they can enter their PIN remotely — the token is issued by the server, not the device, so any manager signed into any device can authorise an action for another staff member by entering their own credentials at the override prompt.
### Permissions needed for overrides
Overrides are granted based on the manager's role:
* **Editing another waiter's locked order** — the manager must have the "Open Others' Orders" permission
* **Accepting a shift variance** — the manager must have the "Close Shift with Variance" permission
* **Tax exempt** — the manager must have the "Tax Exempt" permission
* **Voiding items or orders** — the manager must have the "Void Order" permission
If the entered PIN belongs to a user who does not hold the required permission, the override is rejected and the action does not proceed.
Permissions are configured in the web admin under **Staff → Roles**. See [Creating Roles and Applying Permission Tiers](/staff/roles-and-tiers) for guidance.
***
## Permissions summary
| Who can do this | What they need |
| ---------------------------------------------- | ---------------------------------------------------------- |
| View Settings | All signed-in staff |
| Change theme, language, timeout | All signed-in staff |
| Configure printers, QSR mode, terminal pairing | Staff with admin-level app settings access |
| Approve a manager override prompt | Staff whose role includes the specific override permission |
***
## Related
* [Logging In, Quick PIN, and Switching Users](/epos-app/login-and-pin)
* [Pairing the Device to a POS Terminal](/epos-app/terminal-pairing)
* [Opening and Closing Shifts on the ePOS App](/epos-app/shifts-and-cash)
* [Manager Override PINs for Sensitive Actions](/staff/manager-override-pins)
* [Creating Roles and Applying Permission Tiers](/staff/roles-and-tiers)
* [Waiter App (ePOS) Settings](/settings/waiter-app-settings)