Few things are more frustrating than a printed QR code not scanning just when customers need it. The good news is that the cause is almost always one of a dozen simple problems, and most can be diagnosed in a couple of minutes with your own phone. This guide helps you separate design problems from phone problems and from broken destinations.
First: is it the code, the phone or the link?
Start by narrowing down where the problem comes from. Run this quick diagnosis:
- Scan with a second phone. If the second phone reads it, the issue is the first phone (settings, camera, app).
- Scan the original digital file on a screen. If the file scans but the print does not, the problem is printing: size, contrast, paper or finish.
- Read the code with an online scanner. Upload the image to the online QR code scanner. If it decodes, check that the content shown is exactly what you expected.
- Open the decoded link manually in a browser. If the page fails, the code is fine and the destination is broken.
Design and print causes (the most common)
1. The code is too small
Phones need each module (the small squares) to be large enough to separate. A good rule: code width ≈ one tenth of the scanning distance, with a minimum of about 2 cm for close reading. A poster read from 2 m needs a code around 20 cm wide.
2. Low contrast or wrong colors
Light gray, yellow, pastel or metallic codes often fail. Use a dark code on a light background. Inverted codes (white on black) are not read by every scanner.
3. The quiet zone was cropped
The QR standard (ISO/IEC 18004) specifies a blank margin of four modules around the code. Designers sometimes crop it or place text against the edge, and scanners can no longer find where the code starts.
4. The logo is too large
Error correction can rebuild hidden modules, but only up to a limit (about 30% at level H). A logo that is too big, or one that covers the three corner squares, breaks the code.
5. The content is too long
Long links, full vCards and paragraphs of text create a dense grid with tiny modules. Shorten the link, remove optional fields, or print bigger.
6. The image is blurry or stretched
Enlarging a small PNG creates soft edges. Stretching it in one direction distorts the grid. Download an SVG or a large PNG and scale proportionally.
7. Glare, curves and texture
Glossy lamination, screens, bottles and fabrics distort or reflect light. Prefer matte finishes, flatter areas and higher error correction.

Quick reference: symptom, cause and fix
| Symptom | Likely cause | Fix |
|---|---|---|
| Phone never reacts | Too small, low contrast, no margin | Print bigger, darken the code, restore a 4-module margin |
| Works close, fails from afar | Size wrong for distance | Width ≈ distance ÷ 10 |
| Works on screen, not on paper | Ink spread, glossy finish, blur | Use SVG, matte paper, test proof |
| Works on iPhone, not on Android | Inverted colors or older scanner | Use dark on light, lower density |
| Scans but shows an error page | Broken or mistyped link | Fix the destination or regenerate |
| Scans but asks to sign in / pay | Expired dynamic-code service | Replace with a static code |
| WiFi code scans, no connection | Wrong password or security type | Recreate with exact SSID and WPA setting |
Phone-side causes
- Camera scanning is disabled. On iPhone, check that "Scan QR Codes" is enabled in the Camera settings. On Android, some phones scan from the camera app, others through Google Lens or a quick-settings tile.
- Dirty lens. A fingerprint on the lens is a surprisingly frequent cause. Wipe it.
- Too close or too far. Move back slowly until the whole code, including margins, fits the frame.
- Poor light. Dim rooms and strong backlight both reduce contrast. Turn on the flashlight if needed.
- Old operating system. Very old phones may need a scanner app.
Special cases: WiFi, vCard and payment codes
Some QR code types fail in ways that look like a scanning problem but are really a content problem. A WiFi code may scan instantly and then refuse to connect: the network name (SSID) is case-sensitive, the password must match exactly, and the security type (WPA/WPA2, WEP or none) must be correct. Hidden networks need the "hidden" option enabled. A vCard code can scan but import badly if fields contain unusual characters or if the card is very long; keep it to name, phone, email and website. Payment and crypto codes can be rejected by a wallet app if the format is not the one it expects, so always test with the app your customers actually use.
Screens are another special case. A code displayed on a phone or monitor can be hard to read because of screen brightness, moiré patterns or reflections. Increase the brightness, enlarge the code on screen and avoid dark mode filters that invert colors.
Destination causes: the code works but the page does not
Sometimes the code decodes perfectly but people still say it is "not working". Typical reasons:
- The website was redesigned and the old URL now returns a 404 error.
- The link was typed without https:// or with a typo.
- The document was moved or the sharing permission on a cloud file was changed to private.
- The code was created on a subscription service that deactivates codes after a trial; our guide on whether QR codes expire explains why.
How to rebuild a QR code that scans reliably
- Shorten the content: a short URL or fewer vCard fields.
- Recreate it with the free QR code generator using a dark color on a white background.
- Keep the default 4-module quiet zone and a modest logo.
- Pick the right error correction: M for clean prints, Q or H for outdoor or logo codes (see QR code error correction levels).
- Download SVG for print, then print and test one proof with two phones.
For a WiFi network, recreate the code with the WiFi QR code generator and double-check the network name, which is case-sensitive.
Key takeaways
- Test with a second phone and an online scanner to find where the problem lies.
- Size, contrast and the quiet zone explain most printed-code failures.
- A working code can still lead to a broken page: check the destination.
- Static codes do not stop working on their own; links and subscriptions do.
Prevention is easier than repair. Before any print run, keep a short checklist next to your design file: short content, dark-on-light colors, intact margin, moderate logo, correct size for the distance, SVG export and one tested proof. It takes five minutes and avoids the cost of reprinting.
More background on the format is available on Wikipedia's QR code article.
