How to 3D print a QR code that scans first time

By Tiehl Roberto Matías · 10 min read · Updated 25 October 2026

Leer en español

Nearly every 3D printed QR code that fails to scan fails for the same reason, and it is not the printer. It is a two-line calculation you do before sending the piece to print. Here is that calculation, and the other eight steps it takes to get it right first time.

1. The module is the unit that matters

A QR code is not made of pixels or of millimetres: it is made of modules, the individual little squares it is built from. A version 3 code is 29 modules a side. A version 10 is 57. They are always square and they are always all the same size.

When that code becomes a printed piece, each module turns into a small prism the printer has to raise. And that is where the physical limit almost nobody calculates shows up: a printer cannot draw a square narrower than its nozzle. If the module is smaller than the extrusion width, the machine does what it can: it rounds the corners, joins neighbouring modules that should be separate, and leaves gaps where there should be material.

The phone's camera then sees a smudge, not a grid. And it does not read.

That limit belongs to the printer, not to the code. A resin machine has no nozzle, so the minimum drops a long way and is set by the camera that will read the piece: that is what makes possible the codes that filament cannot manage, and it is in the resin guide (in Spanish).

Twice the nozzle is not a magic number: it is what it takes for each module to be formed by two passes of material and have straight walls instead of one rounded bead. With a single pass the square turns into something closer to a lentil, and the four around it stick to it.

2. Shorten the link before you generate anything

The more characters you put in the code, the more modules it needs, and the more modules it has, the smaller each one is for the same size of piece. It is the cheapest lever you have: removing characters makes the modules bigger without making the object bigger.

These are the real versions that ordinary addresses produce, worked out with the same encoder this site uses, at correction level M:

Link	Characters	Version	Modules
https://a.co/x	14	1	21 × 21
https://qr3dcraft.com	21	2	25 × 25
https://instagram.com/mybusiness	32	3	29 × 29
https://www.mybusiness.co.uk/menu-2026	51	4	33 × 33

The difference between 21 and 33 modules does not look like much on screen, but on a 40 mm piece it means going from 1.4 mm modules to 0.9 mm modules. Any machine prints the first. The second is right on the limit.

Three ways to trim, from most to least advisable:

• Drop what the address does not need. The https:// and the www. take eleven characters and are almost never needed: phones fill the protocol in by themselves. Campaign parameters like ?utm_source=… are another thirty you can avoid.
• Use a short address on your own domain. A redirect from yourdomain.com/m to the long menu takes five minutes to set up and is permanent: if you change platform tomorrow, you change the redirect and the printed pieces keep working.
• An outside shortener works, but keep it on a short leash: if the service closes or the account lapses, every piece you have handed out stops working at the same moment. For something screwed to a wall, it is not worth it.

3. Pick the error correction level

The QR standard stores redundant information so the code still reads with part of it covered or damaged. There are four levels, and each eats into the capacity:

Level	Tolerates damage of	Characters at version 3
L (low)	~7 %	53
M (medium)	~15 %	42
Q (high)	~25 %	32
H (maximum)	~30 %	24

The temptation is to set H «just in case». In 3D printing that is usually a bad idea, for a specific reason: raising the level forces a higher version, and a higher version shrinks the modules. You end up with a code that is theoretically tougher but physically worse printed, which is exactly the damage you were protecting yourself from.

M is the sweet spot for nearly everything that gets printed. Go up to Q or H only when the code will carry a logo in the middle, which covers real modules, or when the piece is going to get dirty or scratched: a keychain living in a pocket, a plate in a workshop.

4. Work out the minimum size of the piece

With the rule from point 1 you can already work out the exact minimum size. The full formula is:

side = (modules + 8) × module size

The eight extra modules are the compulsory quiet zone that point 7 is about. With a 0.4 mm nozzle and therefore a 0.8 mm module, this is the table:

Version	Modules	Code only	With quiet zone
1	21 × 21	16.8 mm	23.2 mm
2	25 × 25	20.0 mm	26.4 mm
3	29 × 29	23.2 mm	29.6 mm
4	33 × 33	26.4 mm	32.8 mm
5	37 × 37	29.6 mm	36.0 mm
6	41 × 41	32.8 mm	39.2 mm
8	49 × 49	39.2 mm	45.6 mm
10	57 × 57	45.6 mm	52.0 mm

That is the absolute minimum, the point where the code prints cleanly with nothing to spare. For real use it pays to leave room, because size also decides how far away it can be scanned from. The practical reference is that a phone reads a QR from about ten times the side of the code:

• Keychain: 40–50 mm. Scanned with the phone in your hand.
• Desk stand: 80–100 mm. Scanned sitting down, half a metre away.
• Wall or window plate: 120 mm or more, depending on the distance.

The whole calculation, with tables for both nozzles, is in the minimum size guide.

5. Pick the two filaments

A QR printed in a single colour is a relief, not a code. The camera needs to tell the dark modules from the light background and, with no colour difference, all it has to work with is the shadow the relief casts, which changes with every lamp in the room. Sometimes it reads. Most of the time it does not.

With two filaments the problem disappears. Two criteria and that is it:

• Light base, dark code. It is the order the standard expects and the one readers handle best. White with black is unbeatable; beige with dark brown, or light grey with navy, work just as well and look better on a table.
• Matte before glossy. A filament with glitter, silk or a metallic finish throws back reflections that the sensor reads as light areas, and part of the code disappears under the ceiling light exactly when somebody tries to scan it. Matte PLA is the most rewarding material for this.

What to avoid without exception: two colours of similar lightness. Red on black, navy on bottle green or mid grey on dark grey look different to the naked eye, but in black and white — which is how the reader processes them — they are almost the same tone. The full list is in the filament colours guide.

6. Decide the relief height

Between 0.8 and 1.2 mm on plates and stands, which is four to six layers of 0.2 mm. That range is not arbitrary:

• Below 0.6 mm the colour change can come out translucent, especially with light filaments over dark ones, and the contrast drops exactly where it is needed most.
• Above 1.5 mm the relief starts casting its own shadow onto neighbouring modules in side light, and the reader takes that shadow for a dark module.

On small pieces the figure is different: 0.6 mm. The real ceiling depends on module size, because the wall of the relief hides part of the light module behind it as soon as the phone tilts. The short rule is not to go past 70 % of the module, and on a 40 mm keychain that is 0.64 mm: the one millimetre the generator offers by default stops reading at 25° of tilt. The whole calculation is in the relief height guide (in Spanish).

At 1 mm of relief the piece also feels good in the hand, which is half the reason for printing this in 3D instead of sticking on a sticker.

7. Do not trim the quiet zone

Around the code there has to be a plain band in the base colour, four modules wide on each side. It is called the quiet zone and it is not decoration: it is what tells the reader where the code ends. Without it the algorithm cannot find the edges and fails even with a perfectly printed code.

It is the most frequent mistake when somebody designs the piece themselves: the QR gets pushed out to the edge of the keychain to make use of the space and the result never reads. Four modules of 0.8 mm is 3.2 mm a side. That is the plain border to respect before the text, the ring hole or the edge of the piece begins.

8. The three slicer settings

The first layer squashes the modules

If the nozzle runs too low, the first layer spreads — the effect known as elephant foot — and each dark module grows a few tenths on every side. On an ordinary piece that does not matter. On a QR, those tenths close the light corridors separating the modules and turn the grid into patches. If your printer has elephant foot compensation, turn it on; if not, raise the z-offset by a couple of hundredths.

With the piece sitting the way it comes out of the file, the bottom layer is the base and none of this reaches the code. It changes if you turn it over so the code sits against the bed, which gives the smoothest face a printer knows how to make and costs more than it looks: it is measured in the face up or face down guide (in Spanish).

The relief starts where the base ends

That is what makes it possible to print this in two colours on an ordinary single-extruder printer. Nothing needs cutting or splitting: all it takes is setting a filament change at the exact height where the base ends. Every current slicer allows it with a right click on the layer bar. If the base is 2 mm and the layers are 0.2 mm, the change goes at layer 11. For the piece to reach the slicer with the base and the relief already separate you have to download it as 3MF and not STL, for the reasons the file formats guide (in Spanish) compares.

Ironing on the top face

If your slicer has ironing, turn it on for the top surface only. It smooths the face of the code, reduces the nozzle marks between one module and the next, and improves reading noticeably. It makes the print longer, but on a small piece that is minutes.

9. Check it before spending filament

Two checks that take under a minute and save hours of printer time:

1. Scan the preview on screen with your own phone, and with another one if you can. If it does not read on a monitor, with perfect contrast and no shadows, it certainly will not read printed. This step rules out address and correction-level mistakes in one go.
2. Look at the modules in the slicer. Switch to layer view, go to the first layer of the relief and check that the lone modules look like separate squares and not one continuous mass. If they are stuck together, the piece is too small: go back to point 4.

If what you are printing is a run and not a single piece, it is worth extending those two checks into a protocol with the piece in your hand, which is what the testing guide (in Spanish) sets out.

Summary in nine lines

• Minimum module: twice your nozzle (0.8 mm with a 0.4).
• Shorten the link as far as you can: it enlarges the modules for free.
• Correction level M, unless it carries a logo or will take a beating.
• Minimum side = (modules + 8) × module size.
• Light base and dark code, both filaments matte.
• Relief of 0.8 to 1.2 mm on plates and stands; 0.6 mm on keychains and tags.
• Four modules of plain quiet zone on every side, no exceptions.
• Compensate elephant foot and turn on ironing.
• Scan the preview before printing.