Fix QR Code Generation & Scanning Problems
Debug QR code issues: codes that will not scan, data too long, encoding errors, and color contrast problems. Generate and test QR codes online.
QR codes fail for predictable reasons: too much data, poor contrast, insufficient quiet zone, or encoding mismatches. This guide covers every common QR code failure.
Common errors covered
Data capacity exceeded (QR code too dense to scan)
QR code generates but phone camera cannot read it
Error: Data too long for QR code version
QR codes have limited capacity: about 4,296 alphanumeric characters for Version 40 (the largest). Long URLs or data payloads may exceed this limit.
Step-by-step fix
- 1 Use our QR Code Generator - it shows data size and error correction level.
- 2 Shorten URLs with a URL shortener before encoding.
- 3 Reduce error correction level from H (30%) to L (7%) to increase capacity.
- 4 For large data, use a short URL that links to the full content.
// Encoding full JSON in QR code
{"user":{"name":"Alice",...200 fields...}}
// Too dense to scan reliably
// Use a short URL instead https://example.com/u/abc123 // Points to the full data, scans instantly
Poor color contrast makes QR code unscannable
QR code does not scan on colored backgrounds
QR code only works in perfect lighting
QR scanners rely on contrast between dark and light modules. Light-colored codes on light backgrounds or insufficient contrast ratios cause scanning failures.
Step-by-step fix
- 1 Use dark modules on a light background (black on white is ideal).
- 2 Maintain at least 40% contrast ratio between foreground and background.
- 3 Our QR Code Generator defaults to black-on-white for maximum compatibility.
- 4 Test by scanning the code in different lighting conditions.
Light gray (#999) modules on white (#fff) background - Insufficient contrast, fails in poor lighting
Black (#000) modules on white (#fff) background - Maximum contrast, works in any lighting
Missing quiet zone prevents scanning
QR code works standalone but not in printed materials
Scanner fails when code is embedded in a design
QR codes require a quiet zone: blank space around all four sides equal to 4 modules wide. When the code is cropped or placed too close to other elements, scanners cannot find the boundaries.
Step-by-step fix
- 1 Ensure at least 4 module-widths of blank space around the QR code.
- 2 Our QR Code Generator includes the quiet zone automatically.
- 3 When embedding in designs, do not crop the white border.
- 4 Test scanning after placing in the final layout (print or screen).
QR code cropped to edges, touching text/borders - Scanner cannot detect code boundaries
QR code with white border (4+ modules) on all sides - Clean separation from surrounding content
Prevention Tips
- Keep encoded data under 100 characters for reliable scanning on all devices.
- Use error correction level M (15%) as a default - good balance between density and recovery.
- Always test generated QR codes with 3+ different scanner apps before distribution.
- Generate codes with our QR Code Generator which includes quiet zone and optimal sizing.
Frequently Asked Questions
What error correction level should I use?
L (7%): maximum data, minimum resilience. M (15%): good default. Q (25%): for printed materials that may be damaged. H (30%): for logos in center or harsh environments.
Can I put a logo in the center of my QR code?
Yes, if you use error correction level H (30%). The logo covers some modules, but H-level error correction can recover up to 30% of damaged data. Keep the logo under 20% of the code area.
What is the maximum data a QR code can hold?
Numeric only: 7,089 characters. Alphanumeric: 4,296 characters. Binary/UTF-8: 2,953 bytes. In practice, keep it under 300 characters for reliable scanning.
Related Error Guides
Related Tools
Still stuck? Try our free tools
All tools run in your browser, no signup required.