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
Section titled “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
Section titled “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:
- Choose the connection type: TCP (network) or USB.
- For TCP: enter the printer's IP address and port (default ESC/POS port is typically
9100). - For USB: select the printer from the detected USB devices list.
- Tap Test print to verify the connection.
- Tap Save.
Access printer setup later
Section titled “Access printer setup later”If you need to reconfigure the printer after initial setup:
- 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.
- Select Change Printer (Android) to re-run printer setup.
- Adjust the settings and save.
Receipt content
Section titled “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.
Reprinting a ticket
Section titled “Reprinting a ticket”After a successful print, the kiosk success card shows a Reprint ticket button for approximately 30 seconds. Tapping it sends the same ticket data to the printer again (byte-identical — same number, header, footer, and timestamp). This is useful when a receipt jams or a customer needs a second 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 a distinct job ID for desk-visibility in the printer status.
Idle return to home
Section titled “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 auto-dismiss pauses if the app is backgrounded and resumes when the app returns to the foreground, so a temporary screen-off does not reset the countdown mid-flow. No configuration is required — the behaviour is always active for unattended deployments.
Customer language
Section titled “Customer language”When your organisation or location offers more than one language, the kiosk shows a per-session language picker so each customer can switch to their own language while they use it. The choice lasts only for that interaction — when the kiosk returns to its idle home screen, it resets to the venue's default language for the next person. Set which languages are offered and the default in admin; see Languages.
Printer status in admin
Section titled “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.