Open QR Maker

Why Won't My QR Code Scan?

The top causes when a code looks fine but cameras refuse to read it.

Last updated

The QR code may look fine, but the camera just sits there when you are trying to scan it. The causes are always the same handful of things, and identifying them should be simple if you know what to look for.

  1. The Code Is Physically Damaged

Smudging, fading, scratches, water damage, sun bleaching. Outdoor codes printed on cheap paper or unprotected vinyl deteriorate fast. If a previously-working code stops working, this is almost certainly why. Consider laminating or using UV-resistant ink.

  1. The Code Is Too Small For The Distance

A code that scans fine on your monitor at arm's length might be unreadable at the distance people will actually scan it from. The size guide covers the common 10:1 sizing rule of thumb (code size ~ scan distance ÷ 10). If you printed a ¾ in code for a poster that gets viewed from 10 ft away, the modules will be too small for the camera to read.

  1. The Contrast Is Too Low

QR scanners require a clear distinction between dark and light modules. Custom color QR codes look great, but they will not scan if the dark color is not dark enough or the light color is not light enough.

A quick test: convert the colors to grayscale in any image editor (or even in your head). If the dark and light values are too close, the code will not scan. Dark navy on cream is fine; dark gray on light gray is not; anything pastel-on-pastel is asking for trouble.

  1. The Logo Is Too Big

A logo overlay covers part of the code. Error correction level H (which Open QR Maker forces when a logo is set) is rated at roughly 30% codeword restoration, but that does not mean you can safely cover 30% of the visible symbol with artwork. Real logos can block finder and alignment patterns long before you hit that number.

Keep the logo small and centered, and test the exact exported asset on multiple phones before print. Open QR Maker defaults to a conservative logo size for that reason: bigger overlays can turn "looks fine on screen" into intermittent scan failures very quickly.

  1. The Quiet Zone Is Missing Or Too Small

The quiet zone is the empty border around the code. The QR specification says four modules of empty space is required on every side. Designers cropping too tight is a common source of unscannable codes. If your design has the QR code touching another element, that's the problem.

Open QR Maker generates the quiet zone for you (defaults to four modules). Make sure nothing overlaps it after you import the SVG or PNG into your design tool.

  1. The Code Is Too Dense For Its Size

A QR code with long content and high error correction has many small modules. At small physical sizes, the modules become smaller than the effective resolution of the QR reader. The fix is either to make the code physically bigger or to reduce the number of modules by either shortening the content or reducing the error correction level or both.

More information on error correction levels can be found in the error correction levels guide.

  1. You Are Scanning With The Wrong App

Some legacy QR scanner apps support fewer formats than the system camera. If your code is a vCard, a WiFi credential, or an email payload, it's recommended to try the iOS or Android system camera app first. Both have native support for the common data types and are as reliable as third-party apps.