Customise the Kiosk

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

Requirements

• Printer support requires a native kiosk app: the Android kiosk app or the desktop kiosk client for macOS, Windows, or Linux. Both include software that communicates with ESC/POS printers over TCP (network) or USB.
• Browser-only kiosk deployments (no native app installed) do not support printing.

Initial setup

After you pair a new Android or desktop kiosk, the kiosk opens the printer setup screen at /setup/printer if no printer is configured. 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. Open the manager menu: five rapid taps in the top-right corner (each within ~1.5 seconds of the last), then enter the manager PIN. See Exit kiosk lockdown for the full gesture.
2. Select Change Printer to open printer setup again.
3. Adjust the settings and save.

Ticket content

Every printed ticket contains:

• Organisation name
• Location name
• Queue name
• Ticket number (large, prominent)
• Ticket header (up to 48 chars) — configured on the location in admin
• Ticket 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.

Reprinting a ticket

After a successful print, the kiosk shows a Reprint ticket button for approximately 30 seconds. Tap it to send an exact copy of the ticket to the printer, with the same number, header, footer, and timestamp. Use this option if a ticket jams or a customer needs another copy.

• Reprinting extends the auto-dismiss countdown so the customer has time to collect the new slip.
• If the printer is unavailable at reprint time, the kiosk shows the printer-unavailable error card.
• Each reprint is logged as a separate print job with its own job ID. Staff can see it in the printer status at the desk.

Idle return to home

The kiosk automatically returns to the home screen after a period of inactivity:

• Success card — dismisses after 30 seconds (extended if the customer taps Reprint).
• Failure card — dismisses after 45 seconds.

The timer pauses when the app moves to the background and resumes when the app returns to the foreground. Turning the screen off briefly does not reset the timer during an interaction. This behaviour is always active and needs no configuration.

Customer language

When your organisation or location offers more than one language, the kiosk lets each customer choose a language for their interaction. When the kiosk returns to its home screen, it resets to the location’s default language for the next customer. Set the available languages and the default in admin; see Languages.

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, check the network or USB connection and make sure the printer has paper. A successful test print from the kiosk resets the status to OK.