QR code not scanning: causes and fixes

By · · Updated · 5 min read
QR code not scanning troubleshooting guide
In short: A QR code usually fails to scan because it is too small for the distance, low in contrast, missing its blank margin, covered by a large logo, blurred, or reflective. Sometimes the code works but the destination link is broken. Test with two phones, fix the design, and re-download a sharp SVG.

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.

Start by narrowing down where the problem comes from. Run this quick diagnosis:

  1. Scan with a second phone. If the second phone reads it, the issue is the first phone (settings, camera, app).
  2. 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.
  3. 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.
  4. 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.

QR code not scanning: test a printed proof with two phones
Always test a printed proof at its final size before a full print run.

Quick reference: symptom, cause and fix

SymptomLikely causeFix
Phone never reactsToo small, low contrast, no marginPrint bigger, darken the code, restore a 4-module margin
Works close, fails from afarSize wrong for distanceWidth ≈ distance ÷ 10
Works on screen, not on paperInk spread, glossy finish, blurUse SVG, matte paper, test proof
Works on iPhone, not on AndroidInverted colors or older scannerUse dark on light, lower density
Scans but shows an error pageBroken or mistyped linkFix the destination or regenerate
Scans but asks to sign in / payExpired dynamic-code serviceReplace with a static code
WiFi code scans, no connectionWrong password or security typeRecreate 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

  1. Shorten the content: a short URL or fewer vCard fields.
  2. Recreate it with the free QR code generator using a dark color on a white background.
  3. Keep the default 4-module quiet zone and a modest logo.
  4. Pick the right error correction: M for clean prints, Q or H for outdoor or logo codes (see QR code error correction levels).
  5. 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.

Recreate a reliable code in seconds, then verify it with the free scanner.

Create a new QR codeScan and check a QR code online

Frequently asked questions

Why does my QR code work on one phone but not another?

Phones use different cameras and scanning software. Older Android phones are less tolerant of inverted colors, low contrast and dense codes. If only one model fails, check its camera settings and lens first; if several fail, make the code larger, darker and less dense so it works for everyone.

Can a printed QR code stop working over time?

A static code does not expire, but the print can degrade: sunlight fades ink and reduces contrast, and scratches damage modules. The destination can also disappear. Outdoor codes should use UV-resistant inks and a higher error correction level, and you should check the link periodically.

Does adding a logo stop a QR code from scanning?

Not if it is done carefully. Keep the logo in the center, away from the three corner squares, and use high error correction (level H). Test the result. If scanning becomes slow, reduce the logo size or remove its background box.

How can I check what a QR code contains without opening it?

Upload or scan the code with an online QR code scanner that shows the decoded content before opening anything. This lets you verify the link or text, spot typos and confirm that the code points where you expect, which is also a good safety habit.

QRCode.boats Editorial Team — QR code & barcode tool makers. Written by the team that builds and maintains the free QR code and barcode generators on QRCode.boats.

Related guides