1. Is it big enough for the distance?
A code scanned from a long way off has to be physically large enough. The rough rule is that the code's width should be at least one tenth of the scanning distance — a code scanned from 30 cm needs to be at least about 3 cm wide. If it's borderline, it might read close up and fail from across the room. See minimum print size.
2. Is there enough contrast?
Your dark modules must be clearly darker than the light ones in brightness, not just in colour. Pale-on-pale combinations, or a code sitting on a similar-toned background, are a classic failure. Light on dark (inverted) codes also fail on many scanners — see our guide on inverted QR codes & dark mode and colors and contrast.
3. Is the quiet zone intact?
The blank margin around the code must be present on all four sides — at least four modules wide — and the same colour as the light modules. If the code was cropped tight, pasted onto a busy background, or boxed in by text, the scanner may not find where it ends. See the quiet zone.
4. Has something covered the data or caused glare?
- A logo that is too large spends more error-correction budget than the code can spare — see the logo size guide.
- Laser-engraved metal tags: Polished metal surfaces cause blinding specular glare and low optical contrast — see our troubleshooting guide for metal tag QR codes.
- Damage, folds, smudges or glare: Printed code on glossy stock reflects ambient light straight into the camera sensor; matte finishes scan substantially better.
5. Is the destination itself broken?
Sometimes the code scans perfectly and the problem is what it points to: a dead link, a typo, a page that needs login, or a site that's slow to load. Decode the code and check the URL by hand in a browser.
6. Is it the scanner, not the code?
Try a second phone and a second app. Point the camera squarely at the code, fill a good part of the frame, and hold steady for a moment. Clean the lens. If other phones scan it, the code is probably fine.
Quick test
- Scan it with two different phones.
- Move closer, then farther — does it ever read?
- Check the margin: is there a clear light border on all sides?
- Regenerate the code with a shorter link and stronger contrast, then re-test.
If it still won't read, it's usually the code rather than the phone — regenerate it rather than reprinting the same problem.
Related guides
Why metal tag QR codes fail
Laser etch depth, specular glare and tag fixes.
TroubleshootingInverted QR codes & dark mode
Why white-on-black fails and safe dark styling.
DesignMinimum QR code print size
Match the code to the scanning distance.
PrintingQR code colors and contrast
Fix pale or inverted codes.
DesignThe QR code quiet zone
The margin you probably cropped away.
DesignRegenerate a clean code
QRacade checks every design with a real decoder before you download it, so an unscannable code never leaves the page. Try the generator or the logo tool.