Why a QR Code Will Not Scan — And How to Fix It
undefined
Low contrast
A QR code needs dark modules on a light background — or the reverse, but never two similar shades. A light-gray code on white, or a dark code on black, gives the decoder almost nothing to lock onto. Contrast is the single most common reason a printed code fails, and it is also the easiest to prevent: print in solid black on white paper whenever possible.
Glare and reflections
Glossy paper, laminated menus, plastic packaging and phone screens all reflect light. A bright reflection across the middle of a code can blind the decoder even when the code itself is perfect. Tilt the code or the camera until the reflection moves off the pattern, or move to a less direct light source.
Too small
Modules shrink as a code gets smaller, and a phone camera can only resolve so much detail. A code meant to be scanned from a phone screen at arm's length needs bigger modules than one held in a hand. If the code is smaller than a postage stamp and you are more than a few inches away, the camera simply cannot focus finely enough.
Too dense
Packing a long URL into a small code forces more modules into the same space, making each one tinier and harder to read. A short URL or a URL shortener keeps the code sparse and easy to scan. If you control the destination, keep the encoded text short.
Inverted (light-on-dark) codes
Some designers print white modules on a black background because it looks striking. Many decoders handle inversion, but many do not — especially older phone cameras and built-in scanners. If an inverted code will not read, that is why. When you are printing, stick to dark-on-light for the widest compatibility.
Screen moiré
Scanning a code displayed on a screen with another screen or camera creates moiré: a wavy interference pattern that overlays the modules and confuses the decoder. Increase the screen brightness, hold the camera steady, and if possible scan a printed copy or a still image rather than a live screen.
Damaged finder patterns
If the three corner finder patterns are torn, covered by a sticker, or cut off at the edge of the print, the scanner cannot orient itself at all. No amount of contrast helps when the decoder cannot tell which way is up. Keep the quiet zone — the blank border around the code — intact, and never crop it off.