Why won't my QR code scan?
Most QR codes that will not scan are too small for the distance, too low in contrast, or missing the white border around the edge. If the code scans but nothing opens, the problem is the link, not the code. Here is how to tell which it is and fix it.
Updated
First, find out where the problem is
There are only three places a scan can fail: the code, the phone, or the link. Thirty seconds of checks tell you which.
- Nothing happens on any phone: the code. Read causes 1 to 8.
- One phone scans it and another does not: the phone. Read causes 9 and 10.
- The phone shows a link, but the page fails to open: the link. Read causes 11 and 12.
Problems with the code
1. Too small for the distance. Phones need each square to be big enough to see. At arm’s length the whole code should be at least 2 cm (0.8 in) wide. A useful rule of thumb is a width of one tenth of the scanning distance: 10 cm for a poster read from 1 metre. The QR code size guide has a full table.
2. Low contrast. Pale grey, yellow or pastel codes often fail, especially in dim light. Use a dark code on a light background. Our generator warns you when the contrast is too low.
3. Inverted colours. A light code on a dark background looks stylish but many phones cannot read it. Keep the code darker than its background.
4. No white border. Scanners need empty space around the code, called the quiet zone, to find its edges. Leave at least 4 squares of blank space on every side, and do not let text, frames or photos run into it.
5. Too much data. Long links and big contact cards make dense codes with tiny squares. Shorten the link, remove optional fields, or print bigger.
6. Logo too big or in the wrong place. A logo that covers a corner square, or more of the centre than the error correction can rebuild, breaks the code. See the logo guide for safe limits.
7. Blurry or stretched. Low-resolution images, screenshots of screenshots, and codes stretched to fit a box all blur the squares. Download SVG or a large PNG and scale it evenly.
8. The surface fights the camera. Glossy lamination causes glare, curved bottles and cups bend the code, and textured paper breaks up thin squares. Use matte finishes, put codes on the flattest part of a curved object, and print bigger on rough materials.
Problems with the phone
9. Camera settings or a dirty lens. Wipe the lens. On an iPhone, check Settings, Camera, Scan QR Codes is on, and use Photo mode. On Android, open the camera or Google Lens; some older phones need QR scanning switched on in the camera settings. How to scan a QR code has the steps for each phone.
10. Distance, angle and light. Hold the phone 15 to 30 cm (6 to 12 in) from a small code, straight on, and let it focus. Avoid shadows across the code and direct reflections of lamps.
Problems with the link
11. Typo, missing page or private file. Scan the code and read the address the phone shows. Open that exact address on a phone using mobile data. Private Google Drive files, form links restricted to an organisation, and pages that were moved are the usual suspects. The Google Drive QR code guide shows the right sharing setting.
12. A dynamic code that was switched off. If the address is a short link on a QR company’s domain and it now shows an error or an advert, the subscription behind it may have ended. Static codes from our generator hold your own link, so they cannot be switched off. Static vs dynamic QR codes explains the difference, and do QR codes expire? covers what to do next.
A checklist before you print
- Scan the code on two different phones, one iPhone and one Android.
- Scan it at the real distance and in the real lighting.
- Print one copy at the final size on the final material and scan that.
- Check the link opens on mobile data, not just your office WiFi.
- Keep the original file so you can reprint without remaking the code.