Why Is My QR Code Not Scanning?

A QR code that will not scan is one of the most frustrating problems because it looks fine to a human eye. The fix is almost never mysterious once you know where to look. Below are 12 common causes grouped into five categories so you can work through them systematically.

Size and contrast problems

Reason 1: The code is too small. The practical minimum for handheld scanning is one inch square. Anything smaller is a gamble. For distant viewing like posters and signs, the minimum size scales with distance: scan distance divided by ten equals minimum code width.

Reason 2: Low contrast. Light gray on white, yellow on white, and similar low-contrast combinations fail even though they look fine on screen. Stick to dark on light. Black on white is the safe default.

Reason 3: Inverted colors. Some designers put light modules on a dark background, thinking it looks sleek. Most scanners refuse to read inverted codes. Keep the dark modules dark and the background light.

For a full sizing reference, read our guide on the best size for a QR code.

Physical damage and layout issues

Reason 4: Missing quiet zone. A QR code needs a blank border around it, at least four modules wide. If the code is crammed against other graphics, the scanner cannot find its edges.

Reason 5: Stretching. Some layout tools let you drag the corners of an image and distort it. A QR code must stay perfectly square. A rectangle will not scan.

Reason 6: Physical damage. Creases, tears, ink smudges, water spots, and fingerprints all eat into the pattern. Error correction can recover from some damage but not all of it. Reprint if the code is obviously beaten up.

The Wikipedia QR code article explains error correction levels in more detail if you want to understand the limits.

Camera, focus, and lighting

Reason 7: Camera cannot focus. Some phones struggle to focus close up. Move the phone slightly further away and let it focus before you try to scan.

Reason 8: Poor lighting. Dim rooms and strong direct light both cause problems. Even lighting without glare works best. If the code is under plastic or glass, tilt the phone to avoid reflections.

Reason 9: Dirty camera lens. Fingerprints and grime on the phone lens soften the image enough to break QR detection. Wipe the lens and try again. This sounds trivial and solves more problems than you would expect.

If the code is behind glossy lamination, the reflection can block the scan. Move the phone to change the angle until the glare disappears and the scan will usually succeed.

Destination URL failures

Reason 10: Broken or expired URL. The code scans, the phone opens a browser, and the browser shows a 404 or a server error. The QR code is fine. The destination is the problem. Fix the URL or swap it. This is trivial with a dynamic QR code.

Reason 11: Firewall or corporate network block. Some networks block redirect chains or specific domains. The QR code works everywhere except inside that network. There is not much you can do except test from a different network.

Dynamic codes help here because you can update the destination in seconds without touching the printed code. Our dynamic QR code generator includes free editing, so a broken URL becomes a one-minute fix.

Device and network quirks

Reason 12: The phone camera does not read QR codes natively. Very old phones need a dedicated QR reader app because the camera cannot decode codes on its own. Most phones from the last five years detect QR codes automatically, but occasionally a rare device does not. Try a different phone to confirm.

Once you have ruled out every cause above, the code itself is probably fine. The issue is almost always environmental: lighting, a specific phone model, or a network block. Try a fresh phone in daylight and you will know.

If you want to catch these problems before they ship, generate your code with scan tracking from our dynamic QR code with tracking tool. You can see exactly when scans succeed and when they fail to reach the destination, which helps you find the root cause faster.