Why your QR code will not scan, and how to fix it
A practical diagnosis sequence for QR codes that scan slowly, work on only one phone or fail completely.
Most scanning failures come from insufficient contrast, a missing white border, a code printed too small for its scanning distance, blur or glare, or damage to the three large corner markers. Test the exported file first, then the real printed object, and only then investigate the destination URL.
Separate recognition from destination problems
A QR scan has two distinct stages. First, the camera must recognise and decode the square pattern. Second, the phone must open the decoded content. A code can decode perfectly while the website is offline, redirects incorrectly or requires a login. It can also point to a healthy page while the printed pattern itself is unreadable.
Start with a modern phone camera in good light. If no link notification appears, the problem is visual. If the link appears but the page fails, copy the decoded address and test it directly in the browser. Keeping those problems separate prevents repeated redesigns of a code whose real problem is the destination.
- ✓Test the original PNG or SVG on a second screen.
- ✓Test the final print, label or sign from its normal distance.
- ✓Try at least two different phones.
- ✓Open the decoded URL directly in a browser.
Check the four visual requirements
A scanner needs a clear difference between dark modules and the background. A pale pattern on white, or a dark pattern on another dark colour, may look stylish but gives the camera little information. Inverted codes can work, but a dark pattern on a light background remains the safest default.
The empty border around the code is called the quiet zone. Text, artwork and crop marks should not enter it. Also inspect the three large position markers in the corners. Rounded styling is usually fine, but covering, stretching or heavily recolouring these markers can prevent the camera from understanding the orientation.
- ✓Use dark modules on a light, plain background.
- ✓Keep an uninterrupted border around all four sides.
- ✓Do not place a logo over a corner marker.
- ✓Avoid transparent exports on a busy photograph.
Inspect the physical result
The file on your laptop is not the finished product. Office printers can soften edges, labels can wrinkle, glossy lamination can create a bright reflection and curved packaging can distort the grid. A code behind glass may scan well during the day and fail under spotlights at night.
Move the phone farther away if the camera cannot focus, and closer if the code occupies only a tiny part of the image. Clean the camera lens and the printed surface. If the code works on paper but not on the final object, the material, placement or lighting is the cause.
| Symptom | Likely cause | First test |
|---|---|---|
| Works on screen, not on paper | Print softness or small size | Print larger with no scaling |
| Works at an angle only | Glare or curved surface | Use matte material |
| Only one phone scans it | Low contrast or marginal detail | Return to black on white |
| Scans but page fails | Destination or redirect issue | Open the URL directly |
Re-export instead of editing a screenshot
Screenshots often introduce resizing, compression and an incomplete quiet zone. Messaging apps may compress the image again. Download a fresh PNG for normal digital use or an SVG for professional printing, place it without stretching and export the complete design at the intended size.
After every change, test the exact file supplied to the printer and a physical proof. A successful test of an earlier draft does not prove that the final crop, colour or lamination will work.
Practical next step
Download the original QR again, test it before placing it in a design, and then compare that result with the final printed object. This tells you exactly where scan quality was lost.
Test a QR image ↗