Why Won't My QR Code Scan? How to Test It Before You Print or Publish

A QR code that fails to scan is almost never a mysterious problem, it's nearly always one of a handful of specific, fixable causes. Here's how to work through them systematically, and a five-minute test you should run before any code goes to print or gets published.

Cause 1: Not Enough Contrast Between the Code and the Background

Scanners rely on a strong contrast difference to distinguish the pattern from its background. A dark code on a dark background, a light code on a light background, or two colors with similar brightness even if they look different to the human eye, can all cause scans to fail intermittently or not at all. The safest combination is still a dark pattern on a light background; if you're customizing colors, check contrast specifically, not just whether the colors look visually distinct to you.

Cause 2: Missing or Crowded Quiet Zone

The blank margin around a QR code isn't optional whitespace, it's how a scanner finds the pattern's edges in the first place. Placing a code too close to text, a photo, or the edge of the printed material removes the visual boundary the scanner needs, and it's one of the most common reasons a code that scans fine on screen fails once it's laid out next to other design elements on a printed page.

Cause 3: Too Much Data Crammed Into Too Small a Space

A long URL, especially one with tracking parameters, forces a denser pattern with smaller individual modules. Printed small, or displayed on a low-resolution screen, that density can push past what the scanning camera can resolve. If a code encodes a lot of content, either shorten the underlying link or increase the print size to compensate, don't assume the same physical size will work regardless of how much is encoded.

Cause 4: A Logo or Damage Covering Too Much of the Pattern

Every code can absorb some coverage before it stops working, but a logo sized too large, or physical damage like a tear, deep scratch, or heavy staining, can exceed what the code's error correction level was built to recover from. If a code will carry a logo, generate it with a high error correction level from the start rather than adding a logo after the fact to a code built for a lower level.

Cause 5: Glare, Lamination, or Screen Reflection

Glossy lamination and reflective materials can bounce enough light back at a camera to wash out the pattern, especially under direct overhead lighting or a phone screen displaying the code at a bright brightness. If a code will be laminated or displayed under bright light, test scanning it at a few different angles and lighting conditions, not just straight-on under even light, before finalizing the material.

The Five-Minute Test Before Anything Ships

1. Print or display it at the actual final size, not zoomed in on a screen or scaled to fit a preview.
2. Scan it with two or three different phones, since camera quality and scanning app behavior vary meaningfully between devices.
3. Scan from the realistic distance and angleit'll actually be used at, not just straight-on from six inches away.
4. Check the destination it lands on,not just that it scans, a code that opens the wrong link is just as much a failure as one that doesn't scan at all.
5. If it's going to print, test the actual printed material, including lamination or the exact paper stock, since materials can affect scanning differently than a digital preview does.

Frequently Asked Questions