Having trouble scanning a barcode in Katana’s mobile apps? Here are the most common reasons why a barcode might not be recognized — and what to do about it.
Note: Barcode scanning is available in the Shop Floor App and Warehouse App. Each app supports specific barcode types depending on the task (e.g. picking, receiving).
Why a barcode might not scan
The printed label is damaged or misaligned
The barcode may be partially cut off, faded, or printed outside the margins.
Fix: Reprint the barcode, ensuring it's centered, clear, and fully visible.
The barcode registered in Katana is incorrect
If the wrong barcode is saved in Katana, the system won’t recognize it when scanned.
Fix: Double-check the item's barcode in Katana’s product or ingredient card.
You're scanning an unsupported barcode type
The barcode you're trying to scan might not be accepted in that specific context.
Example: Scanning an internal barcode during a receiving task in the Warehouse App. Only supplier barcodes are supported there.
Fix: Make sure you’re using:
Registered barcodes during Pick & Pack (Warehouse App)
Supplier barcodes during Receiving (Warehouse App)
Registered item barcodes for ingredient tracking (Shop Floor App)
Tip: Use a dedicated scanner
For more reliable results, especially in high-volume environments, consider using a dedicated infrared barcode scanner (handheld or built-in). These tend to be more accurate and faster than using a smart device camera.
Your feedback is invaluable. Let us know your thoughts on this article or anything in Katana you'd like to see improved: [email protected]