1. Low contrast between the code and background
Scanners look for dark modules on a light background. Dark foreground on a light background is safest. Light-on-dark (inverted) codes fail on many older scanners, and pale colors like yellow on white are unreliable.
2. The code is printed too small
As a rule of thumb, print a QR code at least 2 x 2 cm (about 0.8 in), and larger if people scan from a distance. A good guide is a 10:1 ratio: scanning distance divided by ten gives a minimum code width. A code read from 1 m away should be at least 10 cm wide.
3. No quiet zone
The quiet zone is the blank margin around the code. The QR standard asks for four modules of empty space. If text, borders or photos touch the code, scanners can fail to find it.
4. Too much data in the code
The more characters you encode, the denser and smaller each square becomes. A long URL with tracking parameters makes a crowded code that is hard to read. Shorten the link, or link to a short page address instead.
5. Wrong or broken content
A WiFi code with a typo in the network name or password will scan fine but fail to connect. A URL missing https:// may be read as plain text. Always test the final code with your own phone before printing.
6. Damaged or stretched artwork
Do not stretch a QR code to fit a layout, and do not compress it as a low-quality JPEG. Export as SVG or a large PNG so edges stay sharp.
7. Logo or decoration covering too much
Error correction lets a code survive some damage, but only up to a limit. Placing a large logo over the center can push it past that limit. Read more in our error correction guide.
8. Glare, curved or reflective surfaces
Glossy paper, shiny metal and curved bottles bounce light into the camera. Use a matte finish and a flat surface where you can.
9. The scanner, not the code
If other codes scan fine, the problem is the code. If none do, clean the lens, enable QR scanning in camera settings, or try Google Lens. See how to scan a QR code.
Quick test: before you print 500 copies, scan the code on two different phones, from the real viewing distance, in the real lighting.
A quick diagnosis checklist
If you want to find the cause fast, ask these questions in order. First, does the code scan on a different phone? If yes, the problem is the first phone's camera or settings. Second, does it scan on a screen but not on paper? Then the print is the issue: usually size, contrast or glossy finish. Third, does it scan but open the wrong thing or fail to connect? Then the data inside is wrong, and you should regenerate it with corrected content. Fourth, does it scan only when very close? Then the code is too small or too dense for the viewing distance.
Problems specific to each QR type
WiFi codes
The most common cause of failure is a wrong security type. If your network uses WPA/WPA2 but the code says an open network, phones will not connect. Network names and passwords are also case sensitive, and special characters such as semicolons, colons and backslashes need to be escaped correctly in the WiFi format. A generator that handles this for you avoids typos. Some phones also refuse to auto-join 5 GHz-only or enterprise networks.
Contact (vCard) codes
Contact codes contain a lot of text, so they are dense. Keep fields short: name, one phone number, one email and one website are usually enough. Very long job titles, addresses and notes make the code crowded, which makes it harder to scan at small sizes.
URL codes
Make sure the link starts with https:// and opens correctly in a normal browser first. If the page needs a login, scanners will land on the login page instead. Avoid link shorteners from unknown providers, since some get blocked by phones.
Text codes
Very long text produces large, complex codes. If you need to share more than a few hundred characters, put the text on a web page and encode the link instead.
Best practices before you print
- Test with at least two phones, one iPhone and one Android.
- Test at the real distance and in the real light.
- Print a single sample first and scan the printed version, not just the screen version.
- Keep an SVG or high-resolution PNG so you can reprint without quality loss.
Frequently asked questions
Why does my QR code scan on screen but not on paper?
Printers can blur edges, shrink the code or use light ink. Increase the size, use pure black on white, and export a vector SVG for printing.
Why does my phone say "no usable data found"?
The camera saw the code but could not read valid data. The usual causes are damage, extreme glare or a code that was generated incorrectly. Regenerate and test again.
Do QR codes expire?
Static codes never expire because the data is stored inside the pattern. Dynamic codes depend on a provider's server and can stop working if the account lapses.
Create a Free QR Code
No signup, no expiry, nothing uploaded. Generated in your browser.
Open the Generator →