Why Your QR Code Won't Scan (And How to Fix It)

A QR code that scans perfectly on your laptop screen can fail on every phone in a printed flyer. The code isn't broken — it's usually one of a handful of physical constraints that only show up once the code leaves the screen: contrast, quiet zone, or size relative to encoded data.

The quiet zone is not optional whitespace

Every QR code needs a blank margin — the "quiet zone" — around its border for a scanner to even recognize where the code starts. Crop a QR code tight to its edge, or overlay it directly against a busy background image with no padding, and scanners lose the ability to lock onto it at all. The fix is mechanical: keep at least 4 modules (roughly the width of 4 of the small squares) of clear space on all four sides.

Low contrast kills scans before error correction can help

QR readers depend on distinguishing dark modules from light ones. A light-gray code on a white background, or a code printed on textured/reflective paper, can drop below the contrast threshold scanners need — even though it looks readable to a human eye squinting at a monitor. Pure black on pure white is the safest combination; branded colors are fine as long as the contrast ratio stays high.

Error correction level trades data capacity for damage tolerance

Every QR code is generated with one of four error-correction levels:

• L (Low) — ~7% of the code can be damaged/obscured and still scan. Maximizes data capacity.
• M (Medium) — ~15% damage tolerance. The common default.
• Q (Quartile) — ~25% damage tolerance.
• H (High) — ~30% damage tolerance. Best for codes that will have a logo overlaid on them, or that'll be printed somewhere that gets scuffed.

A code with a logo dropped in the middle needs H-level correction to survive — if it was generated at L or M, that same logo placement can push it past the point of recoverability.

Size versus encoded data

The more data you encode — a long URL versus a short one — the denser the module grid becomes, which means it needs to be printed larger to stay scannable at typical phone-camera distances. A URL shortener isn't just cosmetic here: shorter encoded text means a simpler, more scan-friendly code at the same print size.

Try it

The QR Code Generator builds codes for URLs, Wi-Fi credentials, contact cards, and more entirely in your browser, with logo overlay support and adjustable error correction — so you can generate a code that's actually built to survive being printed, not just to look right on screen.