QR Code Troubleshooting — Why Codes Fail and How to Fix Them

Size too small: the most common failure cause

One of the most common causes of QR code scan failure in the real world is a code that was printed too small. Many designers and marketers think of QR codes as compact elements that can be reduced to fill whatever space is available in a layout. The reality is that there is a minimum functional size that depends on the content density of the specific code.

Diagnosis: hold a ruler or measuring tape against the printed code. Measure the width and height. - Under 1.5 cm × 1.5 cm: usually too small for reliable scanning - 1.5–2.5 cm × 1.5–2.5 cm: borderline; may work for short URLs but not dense content - 2.5 cm × 2.5 cm and above: adequate for most content in typical scanning conditions (these are rules of thumb; minimum size depends on how many modules the code has and on scanning distance)

Fix: regenerate or reprint the code at a larger size. For codes that are already printed in a batch, consider whether a poster, sign, or secondary print piece at a larger size can supplement the failed material. Prevention: always check size before sending to print.

Insufficient contrast: another common cause

A QR code scanner looks for contrast between dark modules and light background. If the contrast is insufficient — the modules are not dark enough, the background is not light enough, or there is a pattern behind the code — the scanner cannot reliably distinguish the module pattern.

Common contrast failures: - Medium grey modules on a white background (insufficient luminance contrast) - Dark background with only slightly lighter modules - QR code printed on a coloured paper that reduces the effective contrast - QR code placed on top of a photo or patterned background without a white frame - Printing on a glossy surface that reflects surrounding light and reduces perceived contrast

Fix: increase the contrast between modules and background. Use a dark module colour on a clearly lighter background; black on white is the safest choice. Add a white quiet zone around the code. If printed on coloured material, add a white background box behind the code.

Missing or insufficient quiet zone

The quiet zone — the white border around all four sides of a QR code — is as functional as the code itself. Without adequate quiet zone, scanner software cannot determine where the code begins and ends. Codes positioned flush against other graphic elements, text, or the edge of a label commonly fail for this reason.

Diagnosis: look at the printed code under good lighting. Is there clear white space on all four sides? The quiet zone should be at least as wide as four modules (the small squares in the code). If the code appears right against a border, text, or image on any side, the quiet zone is likely insufficient.

Fix: add white space around the code. In a design application, place the code on a white background rectangle that extends beyond the code edges. When reprinting, ensure the bleed and trim settings do not cut into the quiet zone.

Image quality: blurry or pixelated printing

A QR code printed from a low-resolution PNG image will have blurry module edges, which reduces scan reliability. This is one of the reasons PNG vs SVG format choice matters significantly for print.

Diagnosis: examine the printed code under a magnifier or phone camera zoom. If the edges of the modules are blurry rather than sharp, image resolution is the issue.

Fix: regenerate the code and download as SVG for the next print run. SVG renders at any size with perfect edge sharpness. If SVG is not available, download the largest PNG available and do not scale it up beyond its native resolution. The required pixel dimensions for 300 DPI print: multiply the intended print size in centimetres by about 118 to get the required pixel dimension (e.g., a 5 cm wide code needs at least 591 pixels).

Physical damage to the printed code

Water damage, scratching, folding, tearing, sunlight fading, and contamination with grease or dirt can all damage a printed QR code enough to prevent scanning. The QR code's error correction partially compensates for damage — up to 30% of data can be recovered at level H — but severe damage exceeds the recovery capacity.

Diagnosis: examine the physical code. Is there visible damage to the module pattern? Are modules missing, obscured, or altered?

Fix for current deployment: attempt scanning in better lighting, closer to the code, and with different devices. Sometimes damage that appears severe has not actually corrupted enough data to prevent recovery.

Prevention: laminate codes that will be in high-traffic or high-risk environments. Use error correction level H for any code deployed outdoors or in conditions where wear is expected. Lamination is an effective protection for printed QR codes against water, grease, and routine physical contact (use a matte finish, since glossy lamination can reflect light and hurt scanning).

Device and software issues

Sometimes the code is correct and the scanning device or software is the issue. QR code scanning capability varies across devices and operating system versions.

Common device issues: - iOS below version 11: no native QR scanning in camera app. Solution: update to current iOS or use a dedicated QR scanner app. - Older Android without Google services: no Google Lens, and the native camera may not scan. Solution: install a free QR scanner app from the device's app store. - Dirty or scratched camera lens: reduces image quality available to the scanning algorithm. Solution: clean the camera lens. - Very old, low-resolution cameras: may not resolve small modules. Solution: increase the physical size of the code.

A code that scans on one device but not another is usually a device capability issue rather than a code quality issue. Always test on the least capable device your audience is likely to have, not just the current flagship phone.