Learn PhyGrid

Troubleshooting Queue Kiosk

The kiosk shows “Scan the QR code” instead of services

The kiosk shows this setup screen until at least one queue is selected in its settings.

  1. Open the Queue Kiosk installation and go to the Settings tab
  2. Select at least one queue in Queue Items
  3. Save the settings

The screen shows “Failed to initialize application” or “Waiting for internet connection”

The kiosk can’t reach PhyGrid to load its settings, or the device is offline.

  1. Check that the device is online in Operations → Devices
  2. Check that the Queue Kiosk installation is connected to the device
  3. Check the device’s internet connection
  4. Restart the device

Tickets don’t print, or the kiosk shows the printer error screen

The kiosk first creates the ticket in the queue, then sends it to the printer selected in its settings.

  1. Check that the queue is open in the Queue Manager. A closed queue doesn’t accept new tickets
  2. Check that Select Printer to print in the kiosk settings is set to the printer attached to this kiosk. The list shows printers from all devices in the tenant
  3. Check that the printer is listed in the Peripherals section of the kiosk device. See View peripherals connected to a device
  4. Check that the printer is a USB thermal printer from Epson, Star, Bixolon, Posiflex, Seiko, CITAQ, or ICOD. Other printers are not detected
  5. Check that the printer has paper and is switched on
  6. Restart the device after reconnecting the printer
  1. Add Ticket number to the elements in Printed ticket layout. When the layout has no elements, only the ticket number is printed
  2. Set the logo for printed tickets in Logo URL of the Queue Management installation. The kiosk Logo setting is only shown on screen
  3. Use a dark logo on a white or transparent background. Tickets print in black and white, and light colours print as blank paper
  4. Toggle Print upside down if the ticket comes out upside down

Category buttons are blank or fields show “MISSING TRANSLATION”

Category names and registration fields come from the Queue Management installation. They need a text for every kiosk language.

  1. In the Queue Management installation, add a name in every kiosk language for each category
  2. Add labels and options in every kiosk language for each registration field
  3. Restart the device to load the changes

New categories or registration fields don’t show on the kiosk

The kiosk loads categories and registration fields of the queue once, when it starts. Saving the kiosk settings doesn’t reload them.

  1. Save your changes in the Queue Management installation
  2. Restart the device