QR Code Scanning Problems: A Complete Troubleshooting Guide

The Basics: How QR Code Scanning Works

Before troubleshooting, it helps to understand what's happening when you scan a QR code. Your phone's camera captures an image of the code. Software then analyses that image to identify the three position detection patterns (the large squares in three corners) that tell the scanner where the code is and how it's oriented. Once the code is located, the software decodes the pattern of black and white modules into binary data, which is then interpreted as text, a URL, or another data type.

Problems occur when any part of this chain breaks down: the camera can't capture a clear image, the position patterns aren't detectable, the module pattern is ambiguous, or the software can't interpret the data. Each of these failures has specific causes and solutions.

Problem 1: The Code Won't Scan At All

When a QR code simply won't register, even after multiple attempts, the issue usually falls into one of these categories:

Camera Lens Is Dirty

This is the most overlooked cause. A smudged or dusty camera lens diffuses light and reduces contrast, making the QR code appear blurry to the scanner. The fix is simple: clean your lens with a soft, lint-free cloth. This alone resolves a surprising number of scanning failures.

Code Is Too Small or Too Far Away

QR codes have a minimum scannable size that depends on the scanning distance and the phone's camera resolution. The general rule is the 10:1 ratio: the QR code should be at least 1/10th the size of the scanning distance in width. For a code scanned from 20cm away, it should be at least 2cm wide. For a poster scanned from 1 metre, the code needs to be at least 10cm wide.

If your code is too small, either print it larger or move the scanner closer. For printed materials, test at the actual distance people will be scanning from.

Poor Lighting Conditions

QR codes rely on contrast between dark and light modules. In very dim light, the camera struggles to distinguish between them. In harsh direct light, glare can wash out parts of the code. The ideal condition is bright, diffuse lighting-overcast daylight or well-lit indoor spaces without direct light sources reflecting off the code.

If you're creating QR codes for a specific environment, test them in that environment. A code that scans perfectly in your office might fail in a dimly lit restaurant or a sun-drenched shop window.

Phone Software Is Outdated

Older phones may have less sophisticated camera software, and very old operating systems may not support native QR code scanning at all. iPhones running iOS 10 or earlier require a third-party scanner app. Android phones before Android 9 (Pie) may also need a separate app. If your code works on some phones but not others, check the OS version of the failing device.

Problem 2: The Code Scans But Opens the Wrong Thing

Sometimes the scan succeeds but the result isn't what you expected. This is usually a data encoding issue.

Incorrect Data Format

If you intended to create a Wi-Fi QR code but it opens a web browser, the data was probably encoded as a URL instead of a Wi-Fi credential string. Different QR code types require specific data formats. A vCard needs to begin with BEGIN:VCARD. A Wi-Fi code needs WIFI:T:WPA;S:networkname;P:password;;. Make sure your QR code generator has the correct mode selected for the type of code you want.

URL Encoding Problems

If your QR code opens a URL but the page doesn't load or shows an error, the URL might have encoding issues. Special characters in URLs need to be properly encoded. Spaces should be %20 or replaced with hyphens. Ampersands, question marks, and equals signs have specific meanings in URLs and can cause problems if used incorrectly in the destination. Test your URL in a browser first; if it works there, it should work in the QR code.

Dynamic QR Code Redirect Issues

Dynamic QR codes use a redirect service. If the redirect is misconfigured, slow, or broken, the scan might fail or go to the wrong destination. Check your QR code platform's dashboard to verify the redirect is set correctly. If the redirect service is down, there's nothing you can do but wait for it to be restored-this is one reason some users prefer static QR codes for critical applications.

Problem 3: The Code Scans Sometimes But Not Always

Intermittent scanning problems are often the most frustrating. They usually indicate a borderline issue: the code is almost small enough, almost has enough contrast, or almost has enough error correction.

Low Contrast

The official QR code specification requires a contrast ratio of at least 4:1 between the dark and light modules. In practice, many scanners can handle less contrast, but reliability suffers. If your code uses dark grey on light grey, or a dark color on a coloured background, try increasing the contrast. Pure black on pure white is the most reliable combination.

Be especially careful with printed materials. A design that looks high-contrast on screen may appear much lower contrast on certain paper stocks or under certain lighting conditions.

Insufficient Quiet Zone

The quiet zone is the blank space around the QR code. The specification requires a quiet zone at least four modules wide (four times the width of a single small square in the code). If text, graphics, or other elements encroach on this space, scanners may have trouble detecting where the code begins and ends. This can cause intermittent failures, especially on phones with less sophisticated scanning software.

Low Error Correction Level

QR codes have four error correction levels: L (7%), M (15%), Q (25%), and H (30%). A code with level L error correction can only tolerate 7% of its data being obscured or damaged. If your code is printed on a surface that might get scratched, placed where lighting creates shadows, or designed with a logo in the center, you need higher error correction. Level H allows up to 30% damage while still functioning.

The trade-off is that higher error correction makes the code denser (more modules for the same data), which can make the code harder to scan at small sizes. Balance error correction against your size constraints.

Problem 4: The Code Is Damaged or Partially Obscured

QR codes in the real world get damaged. They get scratched, torn, faded, covered with stickers, or marked with pens. The good news is that QR codes are designed to handle this.

Understanding Error Correction

Error correction in QR codes uses Reed-Solomon encoding, which adds redundant data to the code. When part of the code is damaged, the scanner can reconstruct the missing data from the redundant information. This is why QR codes can still work with logos in the center or with portions torn away.

If your code needs to withstand damage, generate it with the highest error correction level (H). This gives you the most tolerance for damage, though it does make the code larger or denser.

Critical Areas to Protect

While error correction helps, some parts of a QR code are more critical than others. The three position detection patterns (the large squares in three corners) must be intact for the scanner to recognize the code at all. The timing patterns (the alternating black and white lines connecting the position patterns) are also important. If damage affects these areas, the code may fail even with high error correction.

When placing QR codes in locations where damage is likely, try to position them so that the corners are protected. A code placed near the edge of a printed page is more likely to have its position patterns torn or worn.

Problem 5: Scanning From Screens

QR codes displayed on screens present unique challenges. They're increasingly common-on websites, in presentations, on digital signage-but they don't always scan reliably.

Screen Brightness

If the screen displaying the QR code is too dim, the contrast between the code and the background may be insufficient. Increase the screen brightness to maximum when displaying QR codes for scanning. This is especially important for OLED screens where black pixels are completely off and may not provide enough contrast in bright environments.

Screen Glare

Glossy screens reflect light sources, creating glare spots that can obscure parts of the QR code. When scanning from a screen, try to angle the screen away from direct light sources. When creating codes for screen display, consider this limitation and use larger codes that can tolerate some glare.

Refresh Rate Issues

Some screens, particularly older LCD monitors, have a refresh rate that can cause scanning problems when the camera captures an image at a particular moment in the refresh cycle. This can result in horizontal bands or color distortion in the captured image. This is rare with modern screens but can occur with projectors and older displays.

Moiré Patterns

When a camera's sensor grid aligns with a screen's pixel grid, moiré patterns can appear-wavy, distorted lines that interfere with the QR code pattern. This is more common when photographing screens at an angle. Scanning straight-on usually avoids this problem.

Problem 6: Phone-Specific Issues

Different phones have different camera hardware and software, which can affect scanning performance.

Camera Quality

Higher-end phones typically have better cameras with faster autofocus, better low-light performance, and higher resolution. A QR code that scans instantly on a flagship phone might require multiple attempts on a budget device. If you're creating QR codes for public use, test on a range of devices, not just your own phone.

Autofocus Speed

Some phones struggle to autofocus on QR codes, especially if the code is small or the lighting is suboptimal. If the camera keeps hunting for focus without locking on, try moving the phone slightly closer or further away, or tap on the screen to force focus on the code area.

Scanner Software Differences

iPhone and Android handle QR codes differently. iPhones with iOS 11+ scan QR codes directly in the camera app with a notification tap. Android 9+ offers similar functionality, but some Android phones use Google Lens integration, which may have slightly different behavior. Third-party scanner apps vary widely in their capabilities and tolerance for imperfect codes.

Problem 7: Design-Related Scanning Failures

Custom QR code designs can look great but sometimes sacrifice scannability for aesthetics.

Overly Customised Codes

QR codes with heavily modified designs-rounded modules, custom patterns in the position markers, non-standard colors, or artistic elements that break the module grid-may scan on some devices but fail on others. The more you deviate from the standard QR code appearance, the more you risk compatibility problems.

If you want a customised design, test it extensively before committing to print. What looks like a valid QR code to the eye may not decode correctly on all scanners.

Logo Size Issues

Placing a logo in the center of a QR code is a popular branding technique, but the logo must not be too large. The general guideline is that the logo should not cover more than 30% of the code's area, and you should use high error correction (level H) to compensate for the data obscured by the logo. Even then, test the code on multiple devices before printing.

Inverted colors

Standard QR codes are dark on light. Inverted codes (light on dark) are not part of the official specification, and while many scanners can read them, some cannot. If you must use an inverted code, test thoroughly. Avoid inversion for codes that need to work reliably across all devices.

Quick Troubleshooting Checklist

When a QR code isn't working, go through this checklist:

1. Clean the camera lens - This fixes more problems than you'd expect.
2. Check the lighting - Is it too dark? Is there glare? Move to better light if possible.
3. Adjust distance - Move closer if the code is small, further if it's large.
4. Hold steady - Camera shake can prevent a clean capture.
5. Check for damage - Is the code scratched, torn, or obscured?
6. Try a different phone - Determines if the issue is the code or the scanner.
7. Increase screen brightness - If scanning from a screen.
8. Update your phone - Older OS versions may need a scanner app.

When Creating QR Codes: Prevention Checklist

If you're creating QR codes for others to scan, follow these guidelines to minimise problems:

• Use at least 10:1 size-to-distance ratio
• Ensure high contrast (dark on light is safest)
• Include a quiet zone of at least 4 modules around the code
• Use error correction level H if the code might be damaged or will have a logo
• Test on multiple devices before printing
• Test in the actual environment where the code will be used
• Use HTTPS URLs to avoid browser warnings
• Provide context near the code so people know what to expect

Frequently Asked Questions

Why won't my phone scan a QR code?

The most common reasons are: poor lighting (too dark or glare), the code is too small or too far away, the camera lens is dirty, the code is damaged or blurry, or the phone's software needs updating. Try cleaning your lens, moving closer, improving lighting, or restarting your phone.

Do I need a special app to scan QR codes?

Most modern smartphones can scan QR codes directly with the built-in camera app. iPhones running iOS 11 or later and Android phones running Android 9 or later have native QR code support. Just open the camera and point it at the code. Older phones may need a separate scanner app.

Can a damaged QR code still be scanned?

Yes, QR codes have built-in error correction that allows them to be read even when partially damaged. The level of error correction (L, M, Q, or H) determines how much damage can be tolerated. A code with high error correction (level H) can still function with up to 30% of the code obscured or damaged.

Why does my QR code work for some people but not others?

Different phones have different camera capabilities and scanning software. A code that's borderline in size or contrast might work on a newer phone with a better camera but fail on an older device. Always test your QR codes on multiple devices before printing or distributing them.

Can QR codes be scanned from a screen?

Yes, QR codes can be scanned from screens, but there are some challenges. Screen brightness needs to be high enough, screen glare can interfere, and some screens have a refresh rate that causes scanning issues. Increase brightness, reduce glare, and hold the phone steady when scanning from a screen.