Customise the Kiosk

The kiosk can print physical ticket receipts using an ESC/POS printer. Receipts include the organisation name, location name, queue name, ticket number, and the receipt header/footer text you configured on the location.

Requirements

• Android is required for printer support. The Android kiosk app embeds a native bridge that communicates with ESC/POS printers over TCP (network) or USB.
• Browser-only kiosk deployments (non-Android) do not support printing.

Initial setup on Android

After pairing a new kiosk on Android, if no printer has been configured yet, the kiosk automatically redirects to the printer setup screen at /setup/printer. Follow the on-screen prompts:

1. Choose the connection type: TCP (network) or USB.
2. For TCP: enter the printer’s IP address and port (default ESC/POS port is typically 9100).
3. For USB: select the printer from the detected USB devices list.
4. Tap Test print to verify the connection.
5. Tap Save.

Access printer setup later

If you need to reconfigure the printer after initial setup:

1. On the kiosk tablet, tap the settings icon (or use the kiosk settings gesture).
2. Select Printer Setup.
3. Adjust the settings and save.

Receipt content

Every printed ticket receipt contains:

• Organisation name
• Location name
• Queue name
• Ticket number (large, prominent)
• Receipt header (up to 48 chars) — configured on the location in admin
• Receipt footer (up to 48 chars) — configured on the location in admin

To update the header or footer text, go to admin → your location → Edit location.

Printer status in admin

The current printer status is visible in admin under the location’s Devices tab. The status shows:

• OK — the last print job succeeded.
• Error — the last print attempt failed, with a brief reason (e.g. “Connection refused”, “USB device disconnected”).

If the printer shows an error, verify the network/USB connection and check that the printer has paper. A successful test print from the kiosk will reset the status to OK.