Skip to main content
The printer system has two parts that work together:
  • Printer Devices — the physical printers identified by IP address and port.
  • Routing Rules — logic that decides which items or categories print to which device.
Printers page showing a list of printer devices with their IP addresses and status

​
Printer Device Fields

FieldRequiredDescription
NameYesA label to identify this printer, e.g. Kitchen Bar or Front Counter Receipt
IP AddressYesThe printer’s IP address on your local network. Must be static (fixed) — see tip below
PortYesThe network port — default is 9100 for most receipt and kitchen printers
Paper WidthYes58mm or 80mm — must match the paper roll installed in the printer
TypeYesReceipt (customer copy printed after payment) or Kitchen (order docket sent to kitchen)
ActiveNoToggle off to disable this printer without deleting its routing rules
Printers must have a static (fixed) IP address on your local network. If the printer’s IP changes (due to DHCP), it will stop printing. Set a static IP either on the printer itself (via its settings menu or self-test print) or by assigning a DHCP reservation on your router using the printer’s MAC address.

​
Add a Printer Device

1

Go to Manage → Printers

Click Printers in the left sidebar.
2

Click New Printer

Fill in the Name, IP Address, Port, Paper Width, and Type.
3

Test

Click Test Print to send a test page. Confirm the printer receives it before saving.
4

Save

Click Create.
If you enter the wrong IP address, the Test Print will time out and no error will appear on the printer itself. Always verify the IP from the printer’s self-test page (usually printed by holding the feed button while powering on) before saving.

​
Add a Routing Rule

Routing rules decide which items trigger a print job on which printer.
1

Click Routing Rules

On the Printers page, click the Routing Rules tab.
2

Click New Rule

Select:
  • Printer — the target device.
  • Condition — match by category, product, or order mode.
  • Priority — higher priority rules take precedence when multiple rules match the same item.
3

Save

Click Create. Rules take effect immediately on the next order.

​
Troubleshooting

See Printer Not Printing if a printer is not responding.

​
Frequently Asked Questions

Work through this checklist: (1) Is the printer powered on and showing a ready light? (2) Is it connected to the same Wi-Fi or LAN as the POS terminal? (3) Does the IP in the dashboard match the IP on the printer’s self-test page? (4) Is there a routing rule targeting this printer? See Printer Not Printing for a full diagnosis checklist.
Go to Manage → Printers and click Test Print next to the printer. If you see a test page print, the connection is working. If nothing prints, check the IP address and network connection.
Most Epson, Star, and generic receipt printers use port 9100 for RAW printing over TCP/IP. Check your printer’s manual if 9100 does not work — some models use 515 or 631 for alternative protocols.
Yes. Create multiple routing rules pointing to different printers. You can also create rules that match overlapping conditions — for example, one rule sends all food items to the kitchen, and another sends the full receipt to the counter printer.

Print Templates

Customise receipt and kitchen docket layouts

Printer Not Printing

Step-by-step diagnosis guide

Order Modes

Route prints by service type

Categories

Route prints by menu category