Guides / Troubleshooting

Why won't my QR code scan?

Nine times out of ten it's contrast, size or the empty border around the code. Work down this list in order; the most common causes come first.

4 min readTroubleshooting
On this page Problems with the design Problems with size and printing Problems with the content A 30-second test before you print Questions
In short
  • Most failures are contrast, size or a missing border.
  • Big logos and fancy dots use up the safety margin.
  • Always scan a printed copy before a full run.

Problems with the design

1. Not enough contrast

Scanners need dots that are clearly darker than the background. Light gray, yellow, pastel or mid-tone brand colors often fail. Aim for a contrast ratio of 4.5:1 or more, and 7:1 for print. See colored QR codes that still scan.

2. The colors are inverted

Light dots on a dark background work in most new phone cameras but fail in some scanner apps and retail scanners. If it has to work everywhere, use dark on light.

3. The quiet zone is missing

The empty border around the code tells the scanner where the code ends. If text, a photo or the edge of a card runs right up to the code, it may never be found. Keep 4 modules (dots) of clear space on every side.

The quiet zone is the empty border scanners use to find the edges of the code. Labels describe printed, real-world scanning; a clean screen is much more forgiving.

4. The logo is too big

A logo covers part of the code, and error correction has to rebuild what's hidden. Keep the logo under about 25% of the code width and use error correction H. See QR codes with a logo.

Logo width as a share of the code width. Error correction H gives the logo room. Labels describe printed, real-world scanning; a clean screen is much more forgiving.

5. The design is too stylized

Tiny dots, stars and decorative corner squares leave less ink for the camera. They usually still work, but they shrink your safety margin. If a stylized code fails, switch to square or soft dots first.

Every style here scans on a screen. In small print, the ones with less ink per dot lose first. Labels describe printed, real-world scanning; a clean screen is much more forgiving.

Problems with size and printing

6. It's printed too small

A code scans from roughly ten times its width. A 2 cm code works at arm's length; on a poster across the room it needs to be much bigger. See minimum QR code size.

7. It holds too much data

Long tracking links and full contact cards make dense codes with tiny dots. Shorten the link or link to a contact page instead of embedding every field.

More data means more, smaller dots at the same printed size. Labels describe printed, real-world scanning; a clean screen is much more forgiving.

8. It's blurry or stretched

A small PNG scaled up for print gets soft edges. Stretching it in one direction distorts the grid. Use the SVG download for print and always scale proportionally.

9. Glare, curves or creases

Glossy laminate reflects light into the camera, cans and bottles bend the code, and folds break it. Use a matte finish on the code area and keep it off seams. See QR codes on curved surfaces.

Problems with the content

10. It scans but opens the wrong thing

A typo in the link, a missing https://, or a page that has since moved. Scan the code yourself and check the address it shows before printing.

11. The link is dead

Codes from "dynamic QR" services stop working when the subscription ends. Static codes, like the ones QRaft makes, contain your link directly and never expire. See static vs dynamic QR codes.

12. The phone is the problem

Very old phones may need a scanner app; a dirty lens or holding the phone too close also stops focus. Try another phone before redesigning.

Paste your link into the generator. The scan test and contrast check catch most of these problems before you print.

Test my design

A 30-second test before you print

  1. Print one copy at the real size, on the real material if you can.
  2. Scan it with an iPhone and an Android phone, from the distance people will actually stand.
  3. Try it under the lighting where it will hang.
  4. Check that the page it opens is the right one and loads quickly on mobile data.

Questions

Why does my QR code scan on one phone but not another?

Phones use different camera hardware and decoders. A code that only scans on some phones is usually on the edge: raise contrast, enlarge it, or simplify the dot style.

Can a QR code stop working?

A static QR code keeps working as long as the link inside it works. Codes from dynamic QR services stop when the service or subscription ends.

Why does my QR code scan on screen but not when printed?

Printing adds blur, ink spread and glare. Print larger, use the SVG file, increase contrast and avoid glossy finishes over the code.