Kiosk
Why is the front barcode scanner not working?
Fix a side barcode or QR scanner that stops scanning: test it in Staff Mode, check power, reseat the USB cable and power cycle.
📋 Overview
Use this guide when the barcode or QR scanner on the side of the kiosk stops scanning. Most scanner problems can be fixed on site.
- Check for blockages: make sure nothing (stickers, tape, signs) is covering the scanner window.
- Red lights mean power: if red lights flash when you hold something near the scanner, it has power and is connected.
🔧 How to Fix It
Step 1. Test the scanner
- Open Staff Mode and go to Manage > Devices.
- Tap All Devices and open the test for the QR scanner.
- Hold any barcode or QR code in front of the scanner. If a number shows up on screen, the scanner works.
If a number shows up, the scanner hardware works and the problem is likely one barcode or item. If nothing happens, go to Step 2.
Step 2. Check that the staff screen is on
The scanner gets power from the staff screen (Side UX). If the staff screen is off, the scanner won't work.
- Find the power switch on the back of the staff screen and make sure it's ON (I).
- Hold something in front of the scanner. You should see red lights.
No red lights? If the switch is on but there are no red lights, the scanner may not be getting power. Go to Step 3.
Step 3. Reseat the scanner USB cable
- Use the silver latch to open the back cover of the staff screen.
- Find the USB cable labeled "QR Scanner", unplug it, wait a few seconds, and plug it back in firmly.
- If the cables aren't labeled, unplug and replug all the USB cables on the hub.

Still not working? Move the QR Scanner cable to a different port on the hub to check if the port is the problem.
Step 4. Power cycle the kiosk
Follow How do I power cycle the kiosk?. When the kiosk restarts, test the scanner again (Step 1).
🛠️ Troubleshooting
The scanner passes the test but won't scan some items
Issue: The scanner works in the test but fails on certain barcodes at checkout.
Fix:
- Check that the barcode isn't damaged, smudged or too small.
- Try a different item to confirm the scanner reads other codes.
- If certain items always fail, the barcode may be set up wrong in Creator. Contact Mashgin Support.
The scanner worked after reseating, then stopped again
Issue: The scanner works for a while, then stops.
Fix:
- Try a different USB port on the hub.
- Check the cable for damage (fraying or a bent connector).
- If it keeps happening, contact Mashgin Support. The cable or scanner may need replacing.
The scanner is physically damaged
Issue: The window is cracked, the cable is frayed or the base is broken.
Fix: Don't try to repair it. Contact Mashgin Support and include a photo of the damage.
🔗 Related Articles
Need help? Contact support at 📧 help@mashgin.com or call (855) 475-0889
