FDM MODULE SIZE GUIDE

Complete guide to QR code module size for FDM printing

Module size is the bridge between a digital QR matrix and a physical FDM print. It tells you how wide one QR cell becomes in millimeters and is often more useful than the overall QR width when predicting whether the slicer can reproduce the pattern cleanly.

Published by ModuQR 10 min read Updated Oct 15, 2026

Open related tool Browse all guides

QUICK TAKEAWAYS

What matters most

Module size = physical QR grid width ÷ total modules across.
Total modules include the QR matrix plus quiet-zone modules on both sides.
For a 0.40 mm nozzle, ModuQR’s Standard profile targets 0.80 mm/module as a strong starting point.
When payload density increases, overall physical size must increase if you want to preserve the same module width.

What a QR module is

A module is one square cell in the QR grid. Finder patterns, timing patterns, alignment patterns and encoded data are all built from these cells. In a digital image, a module might be several pixels wide. In a 3D model, it becomes a physical square measured in millimeters.

The key question for FDM is whether that square and the neighboring gaps can survive slicing, extrusion and surface finishing without merging or disappearing.

The physical module-size formula

If W is the physical width of the complete QR grid, N is the matrix width in modules and Q is the quiet zone per side, then module size M is approximately W ÷ (N + 2Q). Rearranged, the required width is W = M × (N + 2Q).

This simple formula explains most QR sizing behavior. If N increases and W stays fixed, M decreases. If you want M to stay constant, W must grow with the matrix.

Worked examples with a four-module quiet zone

These numbers describe the QR grid region. A template can add more material around it for a plaque, keychain loop or stand.

Matrix	Total modules	At 0.50 mm/module	At 0.80 mm/module	At 1.20 mm/module
21 × 21	29	14.5 mm	23.2 mm	34.8 mm
29 × 29	37	18.5 mm	29.6 mm	44.4 mm
41 × 41	49	24.5 mm	39.2 mm	58.8 mm
57 × 57	65	32.5 mm	52.0 mm	78.0 mm

Module-to-nozzle ratio as a practical signal

A useful sanity check is module width divided by nozzle diameter. In ModuQR’s Standard strong target, 0.80 mm modules with a 0.40 mm nozzle give a 2.0× ratio. In the Coarse profile, 1.20 mm modules with a 0.60 mm nozzle also give 2.0×.

The Fine profile has a floor of 0.50 mm with a 0.25 mm nozzle, again 2.0×. This does not mean every QR must be exactly two nozzle diameters per module; layer height and other minimums are also considered, and real slicers can behave differently. It is a useful conservative design signal.

What “pass” and “warning” mean in ModuQR

A warning does not mean the print will definitely fail, and a pass does not guarantee a scan. These ranges help prioritize where physical tolerance is becoming tight so you can enlarge the model before committing to a long print.

Profile	Warning module size	Strong/pass module size
Fine 0.25 / 0.12	0.35 mm	0.50 mm
Standard 0.40 / 0.20	0.50 mm	0.80 mm
Coarse 0.60 / 0.28	0.75 mm	1.20 mm

Matrix density changes when content changes

QR versions increase in steps. A small change in payload length or error-correction level can push the code into a larger matrix. That creates a sudden drop in module size if the physical width is fixed.

This is why you should generate the final content before designing the surrounding object. A placeholder URL may produce a smaller matrix than the real destination and make the prototype look safer than the final code.

Module-size workflow for FDM

Use the final payload and error-correction level.
Read the generated matrix dimension.
Keep a four-module quiet zone for the baseline design.
Choose nozzle diameter and layer height.
Set a module target appropriate for the print profile.
Calculate or let ModuQR recommend the required physical size.
Inspect the slicer preview and print a test coupon if the design is near the warning range.

HOW TO VERIFY THIS GUIDE

A reproducible check before you print

Keep the QR payload fixed and change one variable at a time. Watch physical module size and ScanSafe warnings, export the same model to your slicer and inspect the layer preview. The final check is still to scan the finished physical object with a real camera.

Read the editorial and technical methodology

REFERENCES

Primary sources and technical documentation

These references support QR requirements, file formats or general printing constraints. ModuQR-specific FDM targets are labeled as heuristics rather than requirements from these sources.

ISO/IEC 18004:2024 — QR Code symbology specification — ISO
Point for determining the code area — Securing Margin — DENSO WAVE / QRcode.com
Information capacity and versions of QR Code — DENSO WAVE / QRcode.com
Modeling with 3D printing in mind — Prusa Knowledge Base

APPLY THE GUIDE

Measure the module, not just the outer square

Generate the final QR in ModuQR and use its module measurement and Print Forecast to choose a physical size that matches your FDM profile.

Create a QR code as a real 3D object

FREQUENTLY ASKED QUESTIONS

Questions about this topic

What is QR code module size?

It is the physical width of one square cell in the QR grid. For a 3D print, it is measured in millimeters and can be calculated from total QR width divided by the matrix plus quiet-zone modules.

What module size should I use for a 0.4 mm nozzle?

ModuQR’s Standard FDM Beta profile uses 0.80 mm/module as a strong starting target and 0.50 mm as the warning threshold.

Why is module size more useful than overall QR size?

Overall width does not reveal matrix density. Two QRs can be the same width but have different numbers of modules, so the denser one has smaller physical features.