How big should a 3D printed QR code be?
Most QR codes that fail to scan do not fail because of the code itself. They fail because they are too small for the distance they are read from, too dense for the printer, or too low in contrast. This guide gives you simple rules to size a printed QR object before you spend any filament.
Start with the scanning distance
A reliable rule of thumb is that a phone reads a QR code from a distance of about ten times the width of the code. A 4 cm code is comfortable at around 40 cm, which suits a desk, a counter or a table stand. A 10 cm plaque works at about a meter, which suits a shop door. A sign that people will read from a sidewalk or across a room needs to be much larger than most desktop 3D printers can print in one piece, so choose the object type according to where people will stand when they scan.
This is a guideline, not a guarantee. Lighting, the phone camera and how steady the hand is all matter, so treat the rule as a starting point and always test.
Module size: the limit of your printer
A QR code is a grid of small squares called modules. The more data you encode, the more modules the grid needs, and the smaller each one becomes at a fixed physical size. With a typical 0.4 mm nozzle, modules narrower than about 1.5 mm start to lose crisp edges, and the code becomes harder to print and harder to read. The practical consequence is simple: the shorter the text you encode, the larger each module can be and the more reliable the print.
- Prefer a short URL or a short path on your own domain.
- Avoid long query strings and tracking parameters when the object is small.
- For Wi-Fi codes, a shorter network name and password mean a simpler code.
Keep the quiet zone
Every QR code needs an empty margin around it so the camera can tell where the code ends and the background begins. The QR specification calls for a margin of four modules on every side. On a printed object this means you should never let the edge of a stand, the border of a plaque or a decorative frame run right up to the code. Leave a clear border in the base color and the code will lock on much faster.
Error correction: a trade-off
QR codes include redundancy so they can still be read when part of the code is damaged or covered. There are four levels, roughly able to recover about 7% (L), 15% (M), 25% (Q) or 30% (H) of the data. Higher levels are more forgiving of scratches, wear and a logo or icon in the middle, but they also add modules, which makes each module smaller at the same size. For a keychain that will be handled and scratched, a higher level can be worth it. For a desk stand that will sit untouched, a lower level with larger modules is often the more reliable choice.
Contrast: the factor people underestimate
Phone cameras decode brightness differences, not colors. What matters is how much lighter one color is than the other. Dark on light is the safe default. Some scanners cannot read inverted codes (light modules on a dark background), so if you choose that look, test it on more than one phone. Pairs of similar lightness, such as red on orange or blue on purple, are risky even though they look different to your eyes. For a deeper look at color pairs, read our guide to choosing filament colors.
Relief and shadows help
A 3D printed code has an advantage over a flat one: the raised modules cast small shadows, which adds a second kind of contrast on top of color. That is why a raised, two-color code can still read in dim light where a flat sticker struggles. It does not replace color contrast, so keep both.
A quick sizing checklist
- Decide where people will stand and estimate the distance.
- Divide that distance by ten to get the minimum code width.
- Shorten the link until modules are comfortably larger than your printer's limit.
- Keep a clear quiet zone around the code.
- Pick a dark and a light filament with strong contrast.
- Print one, scan it with two different phones in the real location, then print the rest.
When you are ready, design your code in the tool, or see the STL and 3MF pages for format details.