QRBento
Practical guide

Why Is My QR Code Not Scanning?

A troubleshooting checklist for low contrast, missing margins, bad links and print problems.

A QR code can look correct but still fail to scan. The cause is often one of three things: the camera cannot recognize the pattern, the encoded content is not supported, or the destination fails after it opens. Troubleshoot them separately to avoid changing a good QR code for the wrong reason.

1. Check the white space around the edges

QR codes need a quiet zone, usually four modules wide, around all sides. Text, borders, icons or photographic textures placed immediately against the pattern can make detection harder. Export the code with its margin intact.

2. Improve contrast

Use dark modules on a light plain background. Avoid light gray on white, pale brand colors, and dark modules over photographs. If you have reversed the usual colors, test very carefully because scanner compatibility varies.

3. Increase print size

A very dense QR code printed too small is hard for a phone to resolve. Lengthy web links, contact cards and calendar details may require more modules than a short URL. Reduce the data or print it larger if necessary.

4. Test whether a logo is blocking data

Center logos are attractive but cover encoded modules. Even high error correction has limits. Try regenerating a plain version without the logo. If the plain QR works, reduce the logo size or remove it.

5. Check the actual content

A QR code might scan perfectly yet lead to a broken page or open the wrong app. Verify a URL in the browser first. Ensure contact-card information follows a supported format. If a Wi-Fi QR is recognized but will not connect, check the network name, security and password.

6. Look at the physical environment

Reflections on glossy material, creases, low lighting, curved packaging, dirt and motion can interfere with scanning. Try a matte surface with a flat, unobstructed code.

7. Try another camera application

Modern phone cameras typically detect standard QR codes, but they do not all support every payload type. A Google Calendar link opens differently from a vCard or Wi-Fi configuration. Cross-device testing reveals compatibility issues early.

Fast diagnosis: if no camera recognizes the squares, inspect contrast, margin and size. If the squares scan but the action fails, inspect the encoded data or its linked destination.

Generate and retest a QR code →


More helpful QR resources

Explore all guides, get answers in the FAQ, or create your next QR code using the free QRBento generator.