Why Won't My QR Code Scan?

Common reasons QR codes fail to scan and how to fix them.

Most scanning problems have simple causes. Run through this checklist to find yours.

The Usual Suspects

Size: Is the code big enough? Minimum 2cm × 2cm for close scanning, larger for distance. Rule of thumb: QR width should be 1/10 of expected scanning distance.

Contrast: Are the colors different enough? Dark on light works best. Black on white is foolproof. See our colors guide.

Damage: Is anything obscuring the code? Scratches, folds, stickers, or partial coverage can break it.

Focus: Can the camera actually see it clearly? Clean lens, steady hand, good lighting.

When in doubt, go bigger and simpler. Larger codes with high contrast always scan better.

Size Problems

Minimum sizes:

  • 2cm × 2cm (0.8") – Absolute minimum for arm's-length scanning
  • 3cm × 3cm (1.2") – Recommended minimum
  • For posters and signs, scale up based on viewing distance

If it's too small, print it larger. No other fix.

Contrast Problems

QR scanners work by detecting contrast between dark and light areas. When colors are too similar, the scanner can't distinguish the pattern.

Won't scan reliably:

  • Light gray on white
  • Dark blue on black
  • Pink on red

Fix: Use dark foreground on light background. If your brand colors don't have enough contrast, use black on white for the QR code itself.

Physical Damage

QR codes have error correction—they can handle some damage. But too much breaks them. Reprinting is usually the only fix for:

  • Deep scratches through the pattern
  • Fading from sun or wear
  • Fold lines running through the code

Camera Issues

If the code is fine but still won't scan:

Can't focus: Clean the lens, hold steadier, tap to focus, move closer or farther No built-in scanner: Try Google Lens (Android) or a dedicated QR app Old phone: Some very old devices struggle—try a different phone

Environmental Issues

Poor lighting: Add light or use phone flashlight Glare: Change angle, use matte materials instead of glossy Curved surface: Scan straight-on, try different angles

Static Code Too Dense

If you're using a static code with a long URL or lots of data, the pattern becomes very dense and harder to scan at small sizes.

Fix: Switch to a dynamic code (uses a short redirect URL) or print larger. See dynamic vs static codes for more on the difference.

Common Questions

Why does it work on my phone but not others? Test on both iPhone and Android. Different apps have varying QR support.

Why does the customized version fail when plain black-on-white works? Customization can reduce scannability. Simplify: reduce logo size, increase contrast.

It worked yesterday but not today? For dynamic codes, check your dashboard—maybe the destination changed. For static codes, check for physical damage.

Do QR codes expire? Static codes never expire. Dynamic codes work as long as your account is active.