Documentation

Printers and Receipts

Add receipt and kitchen printers, test them, print kitchen tickets automatically and choose what appears on the receipt.

Where each task happens

Task Where
Add, edit or delete a printer Web admin, Point of Sale > Printers
Test a printer from the counter POS app, Settings > Printers
Print kitchen tickets automatically POS app, Settings > Kitchen Settings
Choose what the receipt shows POS app, Settings > Receipt Settings, or Web admin, Settings > Receipt
Printer rules Web admin, Point of Sale > Printer Rules

How the POS app prints

The POS app sends the receipt or kitchen ticket from the device straight to the printer. The device at the counter must therefore be able to reach the printer.

  • Receipts print on the active printer of type Receipt for the branch.
  • Kitchen tickets print on the active printer of type Kitchen for the branch.
  • The POS app uses one printer of each type. If a branch has more than one active printer of the same type, the app uses the one with the lowest Display Order. Automatic kitchen printing uses the printer marked as default first.

Connection types

Connection Type Works on What you enter
Network (IP/Port) Windows, Android and iOS devices on the same network as the printer IP Address and Port. If the port is empty the app uses 9100.
USB/Local The Windows POS app only Local Printer Name: the exact name of the printer as Windows shows it.
Bluetooth, Cloud Print Not usable yet The printer form has no field for a Bluetooth address, so the POS app cannot print to these. Use a network printer with phones and tablets.

Add a printer

Printers are added in the Web admin, for the branch you are working in. You need permission to manage printers.

  1. Open Printers
    Go to Point of Sale > Printers and click Add Printer.
  2. Enter the name and choose the Printer Type
    Choose Receipt for customer receipts or Kitchen for kitchen tickets. For a kitchen printer you can also choose a Kitchen Station. It is optional.
  3. Choose the Connection Type
    For Network (IP/Port) enter the IP Address and Port. For USB/Local enter the Local Printer Name.
  4. Choose the Paper Width
    Pick 58mm, 80mm or 104mm (4 inch) to match the paper roll.
  5. Set Display Order and Set as Default
    If the branch has several printers of the same type, give the one the POS app should use the lowest Display Order and switch Set as Default on.
  6. Click Create Printer
    Leave Active switched on. The POS app ignores inactive printers. You can leave the other fields as they are.

To change a printer later, click Actions on its row in the printer list and choose Edit, Set as Default or Delete.

Test a printer in the POS app

Test from the device that will print, because that device must reach the printer.

  1. Open Printer Settings
    In the POS app go to Settings > Printers. Configured Printers lists the active printers of your branch.
  2. Tap Test on the printer
    The result appears under the printer: Test successful or Could not connect.
  3. Check the receipt printer is marked Default
    If the buttons under Quick Actions are greyed out, tap Set Default on the receipt printer.
  4. Tap Print Test Receipt
    A test page prints. Tap Open Cash Drawer to check that the cash drawer connected to the receipt printer opens.
Set Default in the POS app

Set Default on this screen is remembered on this device and is used by the Quick Actions buttons. It does not change which printer receipts and kitchen tickets go to. That is decided by the printers in the Web admin, as described under "How the POS app prints".

Printing receipts

  • When a payment is approved, the POS app prints the receipt on the receipt printer without asking.
  • To print it again, tap Print Receipt on the payment confirmation, or open the order on the Orders screen and tap Receipt.
  • To print the bill before payment, tap Print Bill on the order.

Printing kitchen tickets

A kitchen ticket (KOT) lists the items of an order for the kitchen. You can print one by hand at any time: open the order on the Orders screen and tap KOT, or tap Print KOT on the order. The KOT button is not shown for completed and cancelled orders.

Print kitchen tickets automatically

With auto-print, a device in the kitchen prints a ticket each time an order is sent to the kitchen, whichever device took the order. Auto-print is switched off until you turn it on, and the setting is saved on each device separately.

  1. Use the device that can reach the kitchen printer
    Sign in to the POS app on that device and go to Settings > Kitchen Settings.
  2. Check SignalR Connection
    It must show Connected. If it shows Disconnected, tap Connect.
  3. Switch Auto-Print Kitchen Tickets on
    The app confirms with "Auto-print enabled".
  4. Choose the Auto-Print Order Sources
    Tap a source to switch it on or off. A selected source has a tick. All sources are selected to begin with.
  5. Send a test print
    Under Kitchen Printers, tap the printer icon on the printer's row.
  6. Open the Kitchen screen
    Automatic printing starts when the Kitchen screen is opened. Open it once each time the app is started on this device.
Order source Orders it covers
POS Orders from in-store POS terminals
Phone/Call Center Orders from call center / phone orders
Online Orders from website ordering
Mobile App Orders from mobile app
Kiosk Orders from self-service kiosks
Third Party Orders from delivery platforms
How auto-print behaves
  • Every device that has auto-print switched on prints its own copy. Switch it on on one device per kitchen.
  • The whole order prints on one kitchen printer. Tickets are not split between printers or kitchen stations.
  • Auto-print also works when the kitchen display is switched off for the branch.

Printer rules

In the Web admin, Point of Sale > Printer Rules lets you record which items should print on which printer. Click Add Rule and enter:

Field Meaning
Rule Name, Priority A name for the rule, and its order among the rules. The lowest number comes first.
Trigger When Send to Kitchen, Payment Complete or Order Created.
Print To, Number of Copies The printer, and how many copies.
Order Types Apply to all order types, or untick it and choose the order types.
What to Print Print all items in the order, or Print only items from specific categories and tick the menu categories.
Printer rules do not change printing yet

The POS app does not use printer rules at present. Rules you create are saved, but receipts and kitchen tickets still print as described under "How the POS app prints": one receipt printer and one kitchen printer per branch.

Receipt settings

Receipt settings are shared by your whole account. You can change them in two places, and both edit the same settings:

  • POS app: Settings > Receipt Settings.
  • Web admin: Settings > Receipt, then Configure Receipt Settings. This page shows a Receipt Preview that changes as you type.

Change what you need and click or tap Save Settings.

Section What you can set
Receipt Header Three lines at the top of the receipt. The POS app calls them Header Line 1, 2 and 3. The Web admin calls them Store Name, Address and Phone/Website.
Display Options (Web admin: Receipt Content) A switch for each of these lines: Order Number, Date & Time, Order Type, Table Name, Cashier Name, Customer Name, Item Modifiers, Special Instructions, Tax Breakdown and Payment Details.
Receipt Footer Footer Line 1, 2 and 3, for example a thank-you message.
Paper Settings Paper Width (58mm or 80mm) and Feed Lines Before Cut (0 to 10 blank lines before the paper is cut).
Good to know
  • Payment Details print only on an order that is paid. Tax Breakdown prints only when the order has tax.
  • The receipt printed by the POS app is text only. The Logo URL is saved but the logo is not printed.
  • The cashier's name is not printed by the POS app at present, even when Cashier Name is switched on.

Troubleshooting

"No receipt printer configured. Please configure a printer in settings."

The branch has no active printer of type Receipt. Add one in the Web admin under Point of Sale > Printers, or switch the existing one to Active.

"No kitchen printer configured. Please configure a printer in settings."

The branch has no active printer of type Kitchen. Add one in the Web admin under Point of Sale > Printers.

"No printers configured for this branch."

The Printer Settings screen of the POS app found no active printers for the branch. Printers cannot be added in the POS app. Add them in the Web admin.

"Branch not configured. Please configure your POS device first."

The POS app on this device has not been set up for a branch. See Install the POS App.

The test shows "Could not connect"

  • Check that the printer is switched on and has paper.
  • For a network printer, check that the device and the printer are on the same network and that the IP Address and Port in the Web admin are correct.
  • For a USB printer, check that the Local Printer Name is exactly the name Windows shows for the printer.

Kitchen tickets do not print automatically

  • On the kitchen device, open Settings > Kitchen Settings and check that Auto-Print Kitchen Tickets is on and SignalR Connection shows Connected.
  • Check that the source of the order is selected under Auto-Print Order Sources.
  • Check that a printer is listed under Kitchen Printers. If the list says "No kitchen printers configured", add a kitchen printer in the Web admin.
  • Open the Kitchen screen once after starting the app.

Every kitchen ticket prints twice

Auto-print is switched on on two devices. Switch Auto-Print Kitchen Tickets off on one of them.

Next steps

Kitchen Display

Follow orders on a screen in the kitchen.

Order Taking

Take orders and payments that print receipts.

Cash Management

Open and close the cash drawer.