QR Code Troubleshooting

A QR code that won't scan is almost never a mystery. It's usually one of a handful of specific, fixable problems. Work through these in order before you assume something is broken.

1. Check the destination first

Before touching the QR code's design, open the exact link, file, or text it points to in a normal browser tab. If the destination itself is slow, broken, deleted, or blocked behind a login, no amount of QR redesign will fix the scan experience. This is the single most common root cause and the easiest to rule out.

2. Check the size against the scan distance

A QR code sized for a business card will not work on a wall sign meant to be read from six feet away. As a rough guide, the code needs to be roughly proportional to the distance people will stand when they scan it: small and close for cards and receipts, noticeably larger for posters, windows, and vehicle graphics. If you are not sure, print a test copy and try scanning it from the real distance before ordering a full run.

3. Check contrast and color

Phone cameras rely on contrast to find the pattern. Light gray on white, pale brand colors, and low-contrast gradients are common causes of a code that scans inconsistently or not at all. Dark foreground on a light background is still the safest default.

4. Check for a cropped or crowded quiet zone

The blank margin around a QR code is not wasted space. It helps the camera identify where the pattern starts and ends. Text, logos, borders, or a tight crop that touches the code directly can cause scans to fail even when the pattern itself is technically correct.

5. Check the logo and error correction settings

If the code has a center logo and it is failing to scan, the two most likely causes are a logo that is too large relative to the code, or an error correction level that is too low to compensate for the covered area. Increase error correction to High or Max and shrink the logo before troubleshooting anything else.

6. Check the physical surface

Glossy lamination, curved surfaces (like cups or bottles), reflective packaging, and textured paper can all interfere with a camera's ability to read the pattern cleanly. If a code needs to sit on one of these surfaces, test a physical sample under the lighting conditions it will actually be used in, not just under office lighting.

7. Check the file itself

A QR code exported as a low-resolution screenshot, rather than downloaded directly as PNG or SVG, can pick up compression artifacts that blur the edges of the modules. Always use the direct export from the generator instead of a screenshot of the preview.

8. Test on more than one device

Camera quality and QR detection speed vary between phones. A code that scans instantly on a newer iPhone might be slower or less reliable on an older Android device. Test the final version on at least two different phones before printing in bulk.

Quick diagnostic checklist

• Does the destination link, file, or text actually work when opened directly?
• Is the code large enough for the distance people will scan from?
• Is there strong contrast between the foreground and background?
• Is the quiet zone intact, with nothing crowding the edges?
• If there's a logo, is error correction set to High or Max?
• Was the file exported directly, not screenshotted?
• Has it been tested on more than one phone, at the real print size?

Frequently asked questions

Last reviewed: July 6, 2026