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. Cloud printers appear in every device's printer list automatically; you don't add them here.

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

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

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 — the ruler overshoots or falls short
• Give the printer a fixed address — nothing found on Wi-Fi, or a printer that stopped working
• Pairing a Bluetooth receipt printer — it isn't in the chooser
• USB on Windows and USB on Linux
• Supported receipt printers

Epson prints nothing

• Epson Secure Printing — a new Epson that appears to send and prints nothing
• Server Direct Print — its web page works but no job prints
• Printed once and then stopped — power-cycle first

Permissions

• iPad and iPhone
• Android
• Browser

Something on the receipt is wrong

• The logo is missing in the browser
• Receipts in Chinese, Thai, Arabic or Cyrillic
• Connecting a cash drawer

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.

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.

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.
Auto-cut paper	Cut the paper after each receipt.
Auto-open cash drawer	Pop a drawer wired to this printer — see cash drawers.
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.

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

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.