FreeQRCode3D עברית

Printed QR code not scanning? A checklist

Updated October 12, 2026 · 7 min read

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

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

Create a QR code keychain