TutorialFebruary 12, 20267 min read

QR Code Not Scanning? Fixes and Best Practices

Your QR code won't scan? Learn common causes and how to fix them. Size, contrast, damage, and placement tips for reliable scanning every time.

By Codzee Team

Introduction

There's nothing more frustrating than creating a QR code only to find it won't scan when customers or users try it. The good news is that most scanning failures have identifiable causes and straightforward fixes. This guide walks you through the most common reasons QR codes fail and how to ensure yours work reliably. For creating new codes, our free QR code generator supports the options you need for high scannability.

Why QR Codes Fail to Scan

QR codes can fail for several reasons: physical damage, poor contrast, incorrect size, bad placement, or encoding issues. Understanding these helps you prevent problems before they happen and fix existing codes when possible.

1. Size Too Small

One of the most common causes of scan failure is a QR code that's too small. When printed or displayed on screen, the code must be large enough for the scanner to resolve the individual modules (the small squares that make up the pattern).

  • Print: Minimum recommended size is about 2 cm × 2 cm (0.8" × 0.8") for close-range scanning; for posters or signs viewed from a distance, use at least 5–10 cm or more.
  • Screen: On websites or apps, aim for at least 100×100 pixels; on mobile, 150×150 pixels or larger is safer.

Our generator lets you choose output size (e.g. 100px to 500px) and download in PNG or SVG for print so you can scale correctly. For more on print dimensions, see our guide on best size and DPI for printing QR codes.

2. Poor Contrast

QR codes need strong contrast between the dark (foreground) and light (background) areas. If the contrast is low, cameras and readers struggle to distinguish the pattern.

  • Use dark foreground (black or dark blue) on a light background (white or light gray).
  • Avoid light-on-light or dark-on-dark; avoid busy backgrounds that blend with the code.
  • If you use brand colors, test scanning before mass printing.

Our tool allows custom colors; keep contrast in mind when customizing your QR code.

3. Damage or Obstruction

QR codes have built-in error correction (we support different levels in our generator), but if too much of the code is scratched, folded, or covered, it may not scan. Keep the code clean and avoid placing logos or text over the critical finder and alignment patterns.

4. Glare and Reflections

Glossy laminates or screens can create glare that confuses scanners. Use matte finishes for print when possible, and avoid placing codes where direct light causes reflections.

5. Wrong URL or Broken Link

Sometimes the code scans correctly but the destination is wrong or broken. Double-check the URL or data you encoded. Ensure the link uses https:// where required; our generator can add the protocol if you omit it. Test the same URL in a browser before blaming the QR code.

Best Practices for Reliable Scanning

  • Test before deploying: Scan with multiple devices (iOS and Android) and in the same environment (e.g. print sample) where the code will be used.
  • Use adequate error correction: If you add a logo, use a high error-correction level so the code can tolerate some obstruction.
  • Leave quiet zone: Keep a margin of white (or light) space around the QR code; don't crowd it with graphics or text.
  • Provide context: Add a short line of text like "Scan for menu" or "Scan to connect" so users know what to expect.

Conclusion

Most "QR code not scanning" issues come down to size, contrast, damage, or environment. By following these fixes and best practices, you can create and deploy QR codes that work consistently. Generate and test your codes with our free QR code generator, and explore more guides on our blog for use cases like restaurants and small business.

About the author

Codzee Team builds free online tools and writes guides to help individuals and small businesses use QR codes and barcodes effectively. We focus on privacy-first, no-signup tools and practical content you can use right away. Learn more on our About page or reach us via Contact.

Tags

#qr codes#troubleshooting#scanning#best practices

Ready to Create Your QR Code?

Try our free QR code generator now!

Generate QR Code