Why isn’t my QR code scanning?

If you’ve created a QR code and it isn’t scanning properly, don’t worry — there are a few common causes and easy fixes. Here’s how to troubleshoot it.

1. Check the contrast and color

The most frequent issue is poor contrast. QR codes need a dark pattern on a light background to be readable by most cameras and apps.

• Avoid light-on-light combinations (e.g. yellow pattern on white background)
• Don’t use colors too similar to each other

→ Read our guide to QR code contrast and color for full best practices.

2. Check the size

QR codes need to be large enough to scan reliably, especially in print.

• We recommend at least 2 x 2 cm (0.8 x 0.8 in) for basic print use
• Use higher resolution formats (SVG or PNG) for large prints
• Don’t stretch or distort the code — keep it square

3. Is your code too dense?

If your QR code contains a lot of data (like a very long URL or vCard), the pattern becomes more complex and harder to scan. To improve readability:

• Use a Short URL if linking to a long web address
• Prefer Dynamic QR Codes over Static — they’re shorter and easier to scan

4. Logo or image is blocking key areas

Adding a logo is totally fine — but make sure it’s placed in the center and doesn’t cover the corners or alignment marks.

• ConnectQR uses high error correction, so the center can be partially covered
• Make sure the corners stay untouched

5. Damaged or blurry code

For printed materials, smudges, poor print quality, or glossy reflections can all interfere with scanning. Try:

• Printing a fresh version of the QR code
• Using matte finishes instead of glossy paper
• Ensuring the print resolution is at least 300 DPI

6. Camera or app issues

Some camera apps (especially older ones) may not scan reliably. Try the following:

• Use the native camera app on iOS or Android
• Try a dedicated QR scanner app (like QR Code Reader)
• Test on a different device to rule out hardware issues

7. Test a clean version

In your ConnectQR dashboard, try regenerating the code without customizations to see if it scans normally. If the plain version works but your custom one doesn’t, the issue may be with colors or styling.

Still not working?

If your code still isn’t scanning after trying the above, feel free to contact our support team with a screenshot or printout of the code. We’ll help you get it working!