Creator
Troubleshooting QR Code Labels
Steps to resolve QR code labels that aren't being recognized on the Mashgin kiosk — covering placement, POS ID setup, duplicate codes, day part availability, and syncing.
📋 Troubleshooting Steps
Step 1. Ensure QR Code is Placed On Top of an Item
We recommend that QR code labels are placed on a flat surface directly on top of a container or item in order to be visually recognized. Labels placed flat on the base of the kiosk will often not be recognized. QR codes must be a minimum of 2 inches × 2 inches in size.
Step 2. Check that the Item has an Associated POS ID
The kiosk matches a QR code to an item using the POS ID field in Creator.
- Open the item in creator.mashgin.com
- Confirm the POS ID field has a value — if blank, enter the REF ID from your QR code label
- Check for duplicates — if two items share the same POS ID, scans will behave unexpectedly
- Check for inactive items — a POS ID attached to an inactive item can block recognition even if an active item also has it
Unsure what the POS ID value should be? Check with your internal team for the REF ID on the label. See How to add and edit menu items for help editing items.
Step 3. Check the Day Part or Availability of the Item
If the item has a Day Part configured, the kiosk will not recognize its QR code outside of those hours.
- Open the item in Creator and check the Day Part / Availability field
- Confirm the current time falls within the available window
- Adjust or remove the restriction if needed
For more information, see How to Add Day Parts.
Step 4. Sync the Kiosk
After making any change in Creator, sync the kiosk before testing again:
- Wait 1–2 minutes for the automatic sync, then re-test the label
- If still not working, enter Manage Mode on the kiosk and press Sync DB
🔗 Related Articles
Still having issues? Send a photo of the QR code label on the item to help us diagnose faster. Contact support at 📧 help@mashgin.com or call (855) 475-0889