Why Some QR Codes Fail to Scan (and How to Fix It)

Almost every "this QR doesn't work" complaint comes down to one of six causes. None of them are mysterious — each one has a test and a fix. Here is the full diagnostic list, from the most common to the rarest.

1. Not enough contrast

The scanner looks for a clear brightness difference between dark and light areas. Failures happen with:

Light gray on white, or navy on black — technically different colors, but the camera sees the same brightness.
Colored-on-colored "designer" QRs. Some work; many do not. Blue on white is usually fine. Red on green is not.
Transparent or translucent backgrounds — light passes through and flattens the contrast.

Fix: dark modules on a light background, or the reverse. Black and white always works.

2. Missing or damaged quiet zone

The quiet zone is the empty margin around the code — the standard requires 4 modules of it on all sides. It is not decoration: it is how the scanner finds the code's edges.

QRs pasted edge-to-edge against busy graphics fail constantly.
Cropped screenshots are the number one culprit on phones: someone screenshots a code and crops it tight.

Fix: keep the margin. Every PIXAROX download includes the quiet zone automatically.

3. Modules too small for the distance

A QR that scans at 20 cm will not scan from 2 m unless it is huge. The rough rule: the QR should occupy about one-tenth of the scanning distance. A 5 cm code works to about 50 cm; a wall sign scanned from 3 m needs to be about 30 cm wide.

Fix: bigger code, or shorter scanning distance. For printed plates, see the size tables in our 3D printing guide.

4. Lighting problems

Condition	What happens	Fix
Direct glare (glossy lamination, glass, sunlight)	Reflection whites out half the code	Matte finish, change angle, shade the surface
Deep shadows	Relief or texture shadows merge modules	Diffuse light from the scanner side
Very dim light	Camera noise blurs the pattern	More light — phone flash helps

5. Physical damage or distortion

Crumples and tears on paper: error correction usually saves it — that is what it is for. Beyond about 30% damage, the code dies.
Stretched or squashed images: QRs must be square. Resizing with the aspect ratio unlocked destroys them.
Low-quality reprints: photocopying a photocopy rounds the module corners until they merge.

Fix: print fresh from the original file — another reason to keep the SVG, which scales to any size with zero loss.

6. The code itself is broken

Rare, but it happens: a QR generated with buggy software, or one encoding more data than the error correction can survive after someone edited the image. If a code generated by a reputable tool fails on every phone, regenerate it and compare the pattern.

A 30-second diagnostic routine

Does it fail for everyone, or just one phone? One phone = camera/settings issue. Everyone = code problem.
Is there a clean margin around the code? If not, restore the quiet zone.
Try changing the angle and distance. If some angle works, it is lighting or glare.
Try the reverse contrast (invert the image) — some scanners prefer dark-on-light.
Still failing? Regenerate the code from the original text and print fresh.

Remember: error correction level matters for printed codes that will get worn or dirty. Level M or Q is the practical choice for plates, stickers and signs; L is fine for clean screens.

Generate a code that works the first time

Every QR from the PIXAROX generator includes the standard quiet zone, uses automatic mask optimization, and offers error correction levels with plain-language explanations — so the code you download scans the first time, on screen or in plastic.