Processed locally
Your input stays in this browser.
The outside square includes a quiet zone
The dark QR matrix is not the whole printed symbol. A common quiet zone is four modules on every side, so a 33 by 33 matrix occupies 41 modules across the complete panel. If the requested outside size is 41 mm, the module pitch is exactly 1 mm. Measuring only the dark square and then trimming the pale margin removes part of the geometry a detector needs to locate the code.
The calculation
For matrix width M, quiet zone Q and outside width W in millimetres, module pitch is W divided by M plus twice Q. Rearranged, required outside width is pitch multiplied by M plus twice Q. The calculator keeps all three numbers visible. It does not call a printer or a server; it turns the entered physical constraints into a reproducible value that can go on an artwork brief.
A worked 37-module example
Take a 37 by 37 module symbol, four modules of quiet zone, and a desired module pitch of 0.8 mm. The complete width is 0.8 × (37 + 8) = 36 mm. If the designer instead has a 30 mm panel, pitch becomes 30 ÷ 45 = 0.667 mm. That is not a cosmetic reduction: every dark cell and every light gap is now one sixth smaller.
Use distance as a starting estimate
For a code a visitor must frame from distance D, a useful initial outside width is about D/10. A tabletop card scanned from 400 mm starts near 40 mm; a poster scanned from 1.5 m starts near 150 mm. This is a framing estimate, not a camera certification. It helps reveal a conflict early: a 20 mm product label cannot reliably serve a task that expects scanning from two metres away.
Printer resolution is a second constraint
At 300 dpi, one dot is about 0.0847 mm. A 0.667 mm module spans almost eight dots before dot gain and resampling; a 0.25 mm module spans about three. The arithmetic does not promise that three dots are acceptable on a particular thermal stock. It shows why a printer proof is essential and why non-integer scaling in a design application can soften module boundaries.
Payload changes size indirectly
The calculator accepts a module count because the same physical label behaves differently for different QR versions. A compact URL may produce 29 modules; a detailed contact or event can produce 49. With W fixed at 40 mm and Q at four, pitch is 1.08 mm for 29 modules but 0.70 mm for 49. Shortening the payload increases pitch without changing the label die-cut.
Failures have measurable causes
A code can be too small for the expected distance, have enough outside width but insufficient quiet zone, or have a usable pitch in SVG and fail after ink spread. Curvature, glare and autofocus add capture failures. Record matrix size, quiet zone, target pitch, printer and scan distance for a test. A vague note that a code was made larger does not let the next operator reproduce the successful condition.
Where the geometry stops
Module pitch predicts only the spacing available to a print process. It cannot reveal whether a supplied raster has been cropped, whether a coloured substrate reduces separation, or whether a camera can focus through glare. The number is therefore a design constraint for an artwork brief, not a retrospective diagnosis or a guarantee of field readability.
Turn the number into a proof plan
A calculation is most useful when it produces a concrete proof requirement. If the page reports 0.667 mm modules on a 30 mm label, record that number with the printer resolution, stock and expected scan distance. Print a plain control first, then the production artwork at exactly 30 mm, and scan both at 600 mm and at the closest realistic distance. If the control passes but the decorated proof fails, the geometry calculation remains correct and the visual treatment is the next suspect. If both fail, increase outside width, reduce payload density or select a different placement. This sequence avoids treating a nominal millimetre value as a promise that ignored the physical reproduction process.
Do not round away the constraint
Artwork notes often say about 1 mm when the actual calculation is 0.667 mm. That difference can decide whether a low-resolution printer produces distinct cells. Keep three decimal places in the production note, then round only for a human-facing description. If a vendor changes a panel from 36 mm to 32 mm, recalculate rather than assuming the same QR remains acceptable. The matrix count and quiet zone have not changed, but every cell has become smaller.
Calculate the whole square, including its margin
A QR matrix with 33 modules is not a 33-module printed object when the quiet zone is included. With four modules of pale margin on every edge, the outside dimension is 41 modules. At 50 mm outside width, the module pitch is 50 ÷ 41, about 1.22 mm. If a longer payload produces 49 matrix modules, the same 50 mm square becomes 57 modules and the pitch falls to about 0.88 mm. Those numbers show why a design can become less robust without any visual warning. ISO/IEC 18004:2024 specifies QR Code dimensional characteristics and quality requirements: https://www.iso.org/standard/83389.html . The calculator makes an initial geometry estimate; the printer and camera still determine the usable limit.
Turn the calculation into a print-proof decision
Start with the intended scan distance, outside panel and the matrix size reported by the generator. Preserve the calculated square when placing the SVG; stretching 50 by 50 mm artwork to 50 by 42 mm changes the modules. Print a flat control and the real substrate, then scan at the actual approach distance and angle. If the control scans but a glossy label fails, investigate reflection, contrast, curvature and placement. If both fail, enlarge the panel or shorten the payload before sacrificing the quiet zone. Record matrix size, outer dimension, module pitch, payload and proof result in the artwork release. A number from this tool does not certify a particular phone, printer resolution, laminate or error-correction setting; it identifies the physical constraint that those tests must respect.
Treat the pitch as a constraint, not a promise
The calculated 1.22 mm or 0.88 mm module pitch is a common language for designer and printer, not a universal pass mark. A scanner, ink process and surface decide whether it is adequate. When space becomes constrained, take a new calculation after every payload or dimension change, then repeat the physical proof. This avoids carrying an old favourable number into a denser, later version of the code.
Allow for the final trim
A panel dimension is useful only after trim, bleed and any protective border are considered. If a 50 mm graphic is trimmed to 48 mm, the module pitch falls with it. Enter the smallest guaranteed outside dimension in the calculation and proof that final size, not the optimistic dimension of the untrimmed layout.