Printed QR code not scanning? A checklist
When a printed QR code fails, the cause is almost always visible if you know where to look. Go through this list in order: the first items are the most common.
1. The squares are too small
If the modules are under about 1.5 mm with a 0.4 mm nozzle, the corners round off and the gaps between squares close up. Fix: make the code bigger or shorten the link so the code needs fewer squares. See how to choose the size.
2. Elephant's foot on the first layer
The first layer is squished onto the bed, so it comes out slightly wider than designed. If the code is printed in the first layers, squares grow into each other. Fix: enable elephant's foot compensation in the slicer, or use a design where the code sits on top of a base, like the files from our generator.
3. Strings and blobs between squares
Thin hairs of plastic across the white gaps confuse the camera. Fix: dry the filament, check retraction settings and remove any purge strand from the nozzle after a filament change. Small strings can be removed with a quick pass of a heat gun or a lighter held at a safe distance, or cut with a hobby knife.
4. Glossy or silk filament
Shiny filaments reflect light straight into the camera and some squares disappear in the glare. Fix: use matte or standard PLA for the code, and avoid ironing the top surface of the code.
5. Not enough contrast
Gray on white, blue on green or two pastel colors may look nice but give the camera little to work with. Fix: dark code on a light base. If in doubt, take a black-and-white photo of the print: if the code is hard to see in the photo, it will be hard to scan.
6. Light code on a dark base
Inverted codes work with most current phone cameras but not with every app. Fix: switch to a dark code on a light base, or test with several phones before printing a batch.
7. No quiet zone
A frame, text or the edge of the object placed right against the code makes it hard to detect. Fix: keep an empty margin about four modules wide around the code.
8. Colors mixed after the swap
If the first code layer still has some base color in it, the squares look washed out. Fix: purge more filament during the swap until the color is clean, and clean the nozzle before resuming. See the filament change guide.
9. Wrong or broken link
Sometimes the print is perfect and the problem is the content: a typo, a link that requires login, or a page that was deleted. Fix: scan the digital version (PNG) before printing and open the link on a phone that is not logged in to your accounts.
10. Bad lighting where it is placed
A code in a dark corner or under a strong spotlight that creates glare can fail even if it is printed well. Fix: place it where there is even light, at a height people can easily point their phone at.
Match the symptom to the cause
- The phone does not react at all: the squares are too small or the contrast is too low. Check the first and fifth points above.
- It scans only from one angle or position: there is glare on the surface or the quiet zone is too narrow.
- It scans on one phone but not on another: look at the contrast, and at a light code on a dark base, which some scanners do not read.
- It scans but opens the wrong page: the problem is the address inside the code, not the print. Fix the link and print a new code.
Try a different scanner before you blame the print
The standard camera app, Google Lens and third-party scanner apps do not behave the same way. If one of them fails, try another, clean the camera lens with a soft cloth and turn the flash off, because the flash creates a bright spot on a raised surface. Hold the phone parallel to the code and move it slowly towards and away from it until the camera finds focus.
Lighting is part of the design
Soft, even light is best. A spotlight or an LED strip pointing at the piece at a shallow angle makes the raised squares cast shadows and reflect light, which turns the code into noise. Matte filament reduces the problem. If you can, test the piece in the exact place where it will be used, at the time of day when it will be used most.
Fix it or reprint it
Thin strings between squares can often be removed with a sharp craft knife, working carefully across the surface. Do not paint or mark over the squares to change their contrast: a small error is likely to make the code worse. If the squares are fused, too small or the wrong colour, the quickest and cheapest answer is to adjust the settings and print again.
How to test before printing many units
- Print one unit first, at the final size.
- Scan it with at least two different phones, one older if possible.
- Scan from the real distance and angle where people will stand.
- Only then print the rest of the batch.