# Receipt Printers

Printer settings live under **POS → Settings → Printing**. Each device keeps its own printers — they are stored on the till, not synced between devices.

Printing to a printer that isn't at this till?

This page covers printers attached to the till by USB or Bluetooth, or on the same Wi-Fi. For a printer in another room or another shop — or one every device should share — see [Cloud Printing](/receipts/cloud-printing.md). Cloud printers appear in every device's printer list automatically; you don't add them here.

## Add a printer[​](#adding-a-printer "Direct link to Add a printer")

1

### Scan

Go to **Settings → Printing** and tap **Add printer**. One scan looks for USB, Bluetooth and Wi-Fi printers at the same time — there is nothing to choose first. Each printer it finds appears as a card as soon as it turns up.

2

### Print a test page

Tap **Print a test page** on the card for your printer. The test page is a numbered ruler across the paper, so it shows the width is right as well as that the printer works.

If the app doesn't already know how wide the paper is, it asks **58 mm** or **80 mm** first.

3

### Answer the question

The app then asks **Did the test page print?** There are three answers:

* **Yes** — the printer is saved and you're done.
* **Printed, but the ruler is off** — the app asks which paper is in the printer and prints the test page again on your answer. See [Getting the receipt width right](/hardware/printers/receipt-width.md).
* **Nothing came out** — you get a one-line explanation of the most likely cause, and what to do about it.

4

### Name it

Once saved, the printer's **name**, **paper width** and **cash drawer** setting sit under its row in **Settings → Printing**. Change them there at any time.

### While the scan is running[​](#while-the-scan-is-running "Direct link to While the scan is running")

Three buttons sit beside the results:

* **Find a Bluetooth printer** — opens your browser's or computer's own Bluetooth chooser. Chrome and the desktop app put printer-like names at the top of the list.
* **Enter an IP address** — stops the scan and checks one address instead. Use this when you know where the printer is and the scan can't see it, which is common on business networks.
* **Stop** — halts the scan. Anything already found stays on screen.

## When nothing prints[​](#when-nothing-prints "Direct link to When nothing prints")

Every trouble screen gives you one line saying what's wrong and what to do, plus two buttons:

* **Copy setup report** — copies what the app tried, what the printer answered, and which connections were open. Paste it into a support message; it saves a long exchange of questions.
* **Open the printer guide** — brings you here.

Pick the guide that matches:

**Setting up**

* [Getting the receipt width right](/hardware/printers/receipt-width.md) — the ruler overshoots or falls short
* [Give the printer a fixed address](/hardware/printers/network-address.md) — nothing found on Wi-Fi, or a printer that stopped working
* [Pairing a Bluetooth receipt printer](/hardware/printers/bluetooth-pairing.md) — it isn't in the chooser
* [USB on Windows](/hardware/printers/usb-windows.md) and [USB on Linux](/hardware/printers/usb-linux.md)
* [Supported receipt printers](/hardware/printers/supported-printers.md)

**Epson prints nothing**

* [Epson Secure Printing](/hardware/printers/secure-printing.md) — a new Epson that appears to send and prints nothing
* [Server Direct Print](/hardware/printers/server-direct-print.md) — its web page works but no job prints
* [Printed once and then stopped](/hardware/printers/printed-once-then-stopped.md) — power-cycle first

**Permissions**

* [iPad and iPhone](/hardware/printers/ios-local-network.md)
* [Android](/hardware/printers/android-permissions.md)
* [Browser](/hardware/printers/browser-permissions.md)

**Something on the receipt is wrong**

* [The logo is missing in the browser](/hardware/printers/logo-missing-browser.md)
* [Receipts in Chinese, Thai, Arabic or Cyrillic](/hardware/printers/non-latin-receipts.md)
* [Connecting a cash drawer](/hardware/printers/cash-drawer.md)

## What each app can connect to[​](#supported-printers-by-platform "Direct link to What each app can connect to")

|                     | Over Wi-Fi                                                                                                                                    | Over USB and Bluetooth                                                                                                                                                                                     |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Web app**         | Epson and Star, through the printer's own web port. On an HTTPS store, Chrome asks for permission to reach your local network the first time. | USB and Bluetooth Low Energy through the browser's own device chooser — Chrome and Edge only.                                                                                                              |
| **Desktop app**     | Any Wi-Fi receipt printer. It scans the network to find them.                                                                                 | USB, Bluetooth Low Energy, and printers already installed or paired in the operating system.                                                                                                               |
| **iPhone and iPad** | Any Wi-Fi receipt printer.                                                                                                                    | Epson and Star through the manufacturers' own software; other makes over Bluetooth Low Energy.                                                                                                             |
| **Android**         | Any Wi-Fi receipt printer.                                                                                                                    | Epson and Star through the manufacturers' own software; other makes over Bluetooth Low Energy, or Bluetooth Classic once [paired in Settings](/hardware/printers/bluetooth-pairing.md#android-pair-first). |

A browser can't open a direct connection to a printer the way an app can, which is why the web app reaches Epson and Star over Wi-Fi but not other makes — those two have a web server built in. For anything else on Wi-Fi, use the desktop or mobile app, or a [cloud printer](/receipts/cloud-printing.md).

## Printer options[​](#printer-options "Direct link to Printer options")

Under each printer's row in **Settings → Printing**:

| Option                    | What it does                                                                                                                                         |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Paper width**           | How many characters fit on a line. Set by the test page — see [receipt width](/hardware/printers/receipt-width.md).                                  |
| **Auto-cut paper**        | Cut the paper after each receipt.                                                                                                                    |
| **Auto-open cash drawer** | Pop a drawer wired to this printer — see [cash drawers](/hardware/printers/cash-drawer.md).                                                          |
| **Set as default**        | Use this printer for any receipt that isn't routed elsewhere.                                                                                        |
| **Full receipt raster**   | Print the receipt as an image instead of text. Slower, but prints any language — see [non-Latin receipts](/hardware/printers/non-latin-receipts.md). |

Looking for "auto-print after checkout"?

Printing a receipt automatically when a sale completes is a **cart setting**, not a printer setting — turn on **Auto-print receipt** in the POS cart settings. *Which* printer it uses is decided by your default printer and by print routing.

## Print routing[​](#print-routing "Direct link to Print routing")

If you use more than one template — say a thermal receipt **and** an A4 invoice — print routing decides which printer each template prints to. Routing has three layers, checked in this order:

1. **Per-job override.** On the receipt screen, a printer dropdown sits next to the template switcher. Picking a printer here overrides everything for that one print job. Switching templates resets it back to **Auto**.
2. **Settings override.** Go to **POS → Settings → Printing**, then use the **Receipt templates** section to assign a specific printer to each template. Set a template back to **Auto** to remove the override.
3. **Auto-match.** With no override, WCPOS matches automatically: thermal templates go to a thermal printer whose width matches (a 58 mm template prefers 32-column printers; an 80 mm template prefers 42 or 48), and HTML templates go to the system print dialog. If several printers match, the **default** printer wins.

If you send a template to an incompatible printer — a thermal template to the system dialog, say — an amber **mismatch warning** appears on the receipt screen. The print still goes ahead, but it may not come out right.

Routing is stored **per device**; each till manages its own.

note

The **Receipt templates** controls only appear once at least one printer is added. With no printers, every template uses the system print dialog. Cloud printers count here too — they appear as routing targets automatically.
