Skip to main content
Troubleshooting

Why Won't My QR Code Scan? Troubleshooting QRTracker QR Codes

Last updated: January 15, 2025

If your QRTracker QR code isn't scanning reliably, this comprehensive troubleshooting guide will help you diagnose and fix the issue. We'll walk through the 7 most common scanning problems—from print size and color contrast to broken links and environmental factors—with specific solutions for both iPhone and Android camera apps. See also our design guide to prevent these issues during creation.

1. Check the Print Size and Resolution

Problem: QR codes that are too small or printed at low resolution won't scan reliably.

Solution:

  • Minimum Size: 2cm × 2cm (0.8" × 0.8") for close-range scanning
  • Recommended Size for Posters/Signage: 5cm × 5cm or larger
  • Resolution: Export at 300 DPI minimum for print. Use SVG format for infinite scalability.
  • Viewing Distance Rule: The farther away users are, the larger your code needs to be. For every meter (3.3 feet) of distance, add 1cm to the code size.

Quick Test: If you can't read the small squares (modules) with your naked eye, it's probably too small to scan consistently.

2. Check Color Contrast

Problem: Low contrast between foreground and background makes QR codes unreadable to cameras.

Solution:

  • Contrast Ratio: Aim for 4.5:1 minimum (use an online contrast checker)
  • Best Practice: Dark foreground on light background (black on white, navy on cream, etc.)
  • Avoid: Light gray on white, yellow on white, dark blue on black
  • Test: Convert your design to grayscale – if the code is hard to see, contrast is too low

Learn more about safe color combinations in our design customization guide.

3. Check for Blurry or Damaged Artwork

Problem: Blurry, pixelated, or physically damaged codes can't be decoded.

Solution:

  • Use Vector Formats: Download SVG instead of PNG for print – vectors never pixelate
  • Check Print Quality: If printed, ensure the printer is set to high quality (not draft mode)
  • Avoid Over-Compression: Don't compress PNG files too aggressively – it creates artifacts
  • Physical Damage: Scratches, tears, or fading can make codes unscannable. Reprint if necessary.
  • Laminate or Protect: For outdoor use, laminate codes to prevent weather damage

4. Test the Link It Points To (No 404s / Bad Redirects)

Problem: The QR code scans, but the link is broken or leads to an error page.

Solution:

  • Test the URL Manually: Copy and paste the destination link into a browser – does it work?
  • Check for Typos: A single character error breaks the link
  • Verify HTTPS: Some devices block non-secure (HTTP) links
  • Check Redirects: If using a URL shortener or redirect, make sure it's still active
  • Monitor Expiration: Some platforms expire links after a certain period

QRTracker Advantage: Dynamic QR codes let you update the destination URL without reprinting. If you find a broken link, just edit it in your dashboard.

5. Try a Different Phone / Better Lighting

Problem: Environmental factors or device limitations prevent scanning.

Solution:

  • Test on Multiple Devices: Try both iPhone and Android. Older or budget phones may struggle.
  • Improve Lighting: Bright, even lighting works best. Avoid harsh shadows or direct glare.
  • Adjust Angle: Hold the phone parallel to the QR code, not at a steep angle
  • Distance: Start 15-20cm away and move closer if needed
  • Clean Camera Lens: A dirty lens reduces focus and scan accuracy

6. Check Camera Permissions

Problem: The phone's camera doesn't have permission to scan QR codes.

Solution:

  • iPhone: Go to Settings → Camera → enable "Scan QR Codes"
  • Android: Open Camera app settings and enable QR code scanning
  • Third-Party Apps: If using a scanner app, check app permissions in device settings
  • Update Software: Make sure the phone OS is up to date – older versions may lack QR support

7. Your Code Might Be Over-Decorated

Problem: Excessive customization (large logo, gradients, patterns) interferes with scanning.

Solution:

  • Logo Size: Keep logos under 30% of the code area
  • Avoid Gradients: Solid colors scan better than gradients or patterns
  • Don't Distort: Never stretch or warp a QR code – keep it perfectly square
  • Simplify Frames: Complex frames can confuse scanners – stick to simple borders
  • Test After Every Change: Scan the code every time you add a design element

Review our guide on safe design practices to balance aesthetics with functionality.

Quick Diagnostic Checklist

Run through this checklist before deploying or reprinting:

  • ✓ Size is at least 2cm × 2cm (larger for distance scanning)
  • ✓ Contrast ratio is 4.5:1 or higher
  • ✓ Image is crisp, not blurry or pixelated
  • ✓ Destination link works when tested manually
  • ✓ Scans successfully on both iPhone and Android
  • ✓ Works in different lighting conditions
  • ✓ Camera permissions are enabled
  • ✓ Logo covers less than 30% of code area
  • ✓ No gradients, patterns, or distortion

Still Having Issues?

If you've tried all these fixes and your QR code still won't scan, it may be a more complex issue. Send us your QR code file and we'll review it for free.

Also consider reviewing our security best practices to make sure users trust that the code is safe to scan.

Frequently Asked Questions

Why does it scan on my phone but not someone else's?

Different phones have different camera quality and QR scanning software. Older devices may struggle with low-contrast or small codes. Always test on multiple devices, especially budget Android models and older iPhones.

Do QR codes expire?

Static QR codes never expire – the data is embedded permanently. Dynamic QR codes (like QRTracker's) don't expire either, but the destination URL could change or be disabled by the creator.

My QR code is blurry — what do I do?

Export at higher resolution (300 DPI for print) or use SVG format, which scales infinitely. If it's already printed, you may need to reprint at a larger size with better quality.

Was this article helpful?

Still need help?

Send us your QR code and we'll review it.