Happy Time

QR code will not scan? Six checks that find the cause in order

4 min read

A QR code that will not scan almost always fails for one of six reasons: content too long, error correction too low, quiet zone cropped away, insufficient contrast, printed too small, or a logo covering data modules. Check them in this order.

First: is it unreadable, or reading the wrong thing?

If the scan produces garbage text or opens the wrong address, the code is fine and the payload is wrong — go back and check what was entered. Only a genuine failure to read is an image problem, and only then do the next five checks matter.

If one app scans it and another does not, suspect the payload format rather than the image: some apps refuse non-http schemes outright, and some collapse bare text into a "copy this" sheet instead of acting on it. Try a full https URL.

Check 2: was the quiet zone cropped?

The quiet zone is the empty margin around the symbol; the standard asks for at least four modules of it. It is not decoration — it is the boundary signal a decoder uses to find the symbol at all. Designs that crop it to one module, or place the code flush against other artwork, give the camera nothing to lock onto. This is the most common cause and the easiest to overlook, especially for codes that were cropped or pasted onto a background. Generate again with four modules of margin, or at minimum stop trimming the white edge.

Check 3: is the contrast high enough

Decoding depends on the luminance gap between dark and light modules. Inverted codes (light modules on a dark background) are technically allowed, but many older scanners only look for dark-on-light and fail outright. Brand-coloured codes have the same problem: pale yellow, light grey and gradients can all fall below the threshold. As a rule of thumb, keep a wide luminance gap and prefer dark modules on a light background. If brand colour is mandatory, push the foreground dark (navy rather than sky blue) and test on a real phone rather than judging on screen.

Check 4: is the payload too long

QR codes have a version ceiling: more data means more modules, which means each module gets physically smaller at a fixed print size. Three hundred characters of CJK text pushes you to version 40 (177 by 177 modules), where each module on a business card is under 0.1 mm and no phone camera can resolve it. The fix is shorter content, not a bigger print: use a short link instead of a long URL, strip tracking parameters, and prefer digits over prose. The same destination via a short link often drops from version 10 to version 3, giving you three to four times the module area.

Check 5: error correction versus the logo

Error correction levels L, M, Q and H tolerate roughly 7, 15, 25 and 30 percent damaged modules. Higher levels survive more abuse but need more modules for the same payload — a trade-off, not a "higher is better" dial. A centre logo is, by definition, deliberate damage. Practical rule: H when the logo covers up to 20 percent of the symbol, Q up to 10 percent, and M with no logo at all for the smallest, easiest-to-scan result. If a logo breaks it, shrinking the logo by a notch usually beats raising the level.

Check 6: physical size and material

On screen, scanning distance is usually 15 to 30 cm. For print, size follows viewing distance: about 2 cm per side works on a business card, while a poster read from two metres needs 8 cm or more. A rough rule is one tenth of the scanning distance. Material matters too: gloss lamination glares under downlights and defeats autofocus, curved surfaces distort the grid, and inkjet output on coated stock bleeds until thin modules merge. None of that is a generator problem, and no setting will fix it.

Common questions

Adding a logo killed the scan. Do I have to lower the level?
Not necessarily — shrink the logo first. Error correction is an upper bound on damaged modules, not permission to cover anything. If the logo clips a finder pattern or a timing pattern (the three large squares and the alternating line between them), no level will save it. Move the logo toward the centre or make it smaller.
How small can a QR code be printed?
It depends on payload length and scanning distance, so there is no single number. A realistic floor: with a short link (around version 3), 1.5 to 2 cm per side in print, or 120 px on screen. If you are already at 1 cm and still need a long URL, shorten the content instead of shrinking further.
It scans in print but not when embedded in a slide
Usually resampling. Stretching a bitmap QR code makes the editor interpolate module edges into gradients, and the decoder can no longer tell dark from light. Generate a large enough bitmap (or use SVG) and scale from there, ideally by integer factors.

Read next

QR code will not scan? Six checks that find the cause in order · Happy Time