> ## 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.

# Printer Configuration and Devices

> Set up printers, configure receipt templates, monitor printer health, review the print job log, and manage which devices are connected to your ePOS.

The Printers hub is your central control panel for everything print-related — adding and naming printers, designing your receipt, checking which devices can reach which printers, diagnosing hardware issues, and reviewing past print jobs. The Devices section lets you see which tablets or phones are signed in and remotely sign them out when needed.

<Note>
  You need the **Manage Settings** permission to work in the Printers hub. Signing devices out requires the **Manage Device Users** permission.
</Note>

## Printers hub

Open **Settings → Printer Configurations** in the web admin. You will see a row of sub-tabs across the top:

| Tab              | What it covers                                                                       |
| ---------------- | ------------------------------------------------------------------------------------ |
| **Printers**     | Add, edit, and delete printer records                                                |
| **Receipt**      | Receipt template and self-serve timeout                                              |
| **Devices**      | Pair devices to printers                                                             |
| **Reach Matrix** | Visual grid showing which devices can reach which printers, plus pending suggestions |
| **Health**       | Live paper, cover, and cutter status per printer                                     |
| **Jobs Log**     | History of print jobs with reprint option                                            |
| **Policy**       | Printing policy and behavior rules                                                   |
| **Help**         | Guided reference within the hub                                                      |

***

### Printers tab — adding and editing printers

<Steps>
  <Step title="Open the Printers tab">
    Go to **Settings → Printer Configurations** and make sure the **Printers** tab is selected.
  </Step>

  <Step title="Add a printer">
    Click **Add printer** (or the equivalent add button). Fill in:

    * **Printer name** — a label you recognise, e.g. "Kitchen 1" or "Counter Receipt".
    * **Type** — the category of printer (receipt, kitchen/KOT, etc.).
    * **Transport method** — how the app communicates with the hardware (for example, over the local network or via USB).
    * **Claim mode** — controls which device or devices are allowed to send jobs to this printer.
  </Step>

  <Step title="Save and test">
    Save the printer record. Then assign it to one or more devices on the **Devices** tab and check the **Health** tab to confirm the printer is reachable.
  </Step>
</Steps>

To edit a printer, click its row and update the fields. To remove one, use the delete option — this also removes it from any device assignments.

***

### Receipt tab — template and self-serve timeout

On the **Receipt** sub-tab you can adjust:

* **Receipt template** — edit the layout and content of printed receipts (header text, footer, which fields appear).
* **Self-serve seconds** — how many seconds a self-serve kiosk waits before printing automatically; set to 0 to disable the timeout.
* **Arabic receipt support** — toggle this on if your receipts need to print in Arabic (right-to-left layout). Make sure the printer's paper width supports it before enabling.

<Tip>
  After changing the receipt template, print a test receipt from the **Jobs Log** tab (reprint any recent job) to verify the layout looks correct before your next service.
</Tip>

***

### Devices tab — pairing devices to printers

The **Devices** sub-tab shows every ePOS device that has connected to this branch. From here you can:

* Assign one or more printers to a specific device so that device knows which hardware to use.
* Remove a pairing if a device is moved to a different station or printer.

Each device entry shows its platform (iOS, Android, Windows), the user currently signed in, and its session status.

***

### Reach Matrix tab

The reach matrix is a grid that maps every device against every printer. A cell indicates whether that device can successfully reach that printer on the network.

* **Green / filled** — reachable.
* **Empty / flagged** — the device has not confirmed connectivity.

The tab also surfaces **pending suggestions** — recommended pairings based on observed connectivity — which you can accept or dismiss.

<Warning>
  A device appearing in the matrix does not mean it is currently signed in; it means it has connected at some point. Check the **Devices** tab for live session status.
</Warning>

***

### Health tab

The **Health** tab shows a live status summary for each registered printer:

| Indicator  | What it means                                                            |
| ---------- | ------------------------------------------------------------------------ |
| **Paper**  | Whether the printer has paper loaded and is not near the end of the roll |
| **Cover**  | Whether the printer cover or casing is properly closed                   |
| **Cutter** | Whether the auto-cutter is functioning normally                          |

A warning icon on any indicator means that printer needs attention before it can reliably complete jobs.

***

### Jobs Log tab

The **Jobs Log** lists recent print jobs across all printers for the branch. Each row shows:

* The job type (receipt, KOT, etc.)
* The printer it was sent to
* Its status (completed, failed, pending)
* A timestamp

Use the **Reprint** action on any row to resend that job to the same printer — useful when a receipt jams or a KOT goes missing.

<Tip>
  If a printer shows repeated failed jobs, switch to the **Health** tab to check paper and cover status before reprinting.
</Tip>

***

### Policy tab

The **Policy** tab contains settings that govern how printing behaves across the branch — for example, rules around automatic printing, fallback behaviour, and job retention. Review and adjust these to match your kitchen and counter workflows.

***

## Device Management

**Settings → Devices** (or the **Devices** sub-tab within the Printers hub) shows all Flutter ePOS terminal sessions currently or recently active for your branch.

<Note>
  You need the **Manage Device Users** permission to sign devices out.
</Note>

Each row in the device list shows:

* **Device platform** — iOS, Android, or Windows.
* **Signed-in user** — the staff account currently using that device.
* **Session status** — active or idle.
* **Last seen** — the timestamp of the most recent activity.

### Signing out a device

<Steps>
  <Step title="Find the device">
    Locate the device in the list. You can identify it by platform, user, and last-seen time.
  </Step>

  <Step title="Sign it out">
    Click **Sign out** next to that device. The session ends immediately; the staff member will need to sign in again to use the ePOS app on that device.
  </Step>
</Steps>

<Warning>
  Signing out a device during an active order will interrupt that session. Confirm with the waiter before signing out a device that is in use.
</Warning>

***

## Related

* [Receipts and Printing Basics](/essential-setup/receipts-and-printing-basics)
* [Print Jobs and Printer Setup on the ePOS App](/epos-app/print-jobs-and-printers)
* [Pairing the Device to a POS Terminal](/epos-app/terminal-pairing)
* [Waiter App (ePOS) Settings](/settings/waiter-app-settings)
* [KOT Settings, Cancel Reasons, and Marking Items 86](/kitchen/kot-settings-and-86)