# Quiet zone requirements — the margin that is part of the spec

> The quiet zone is a border of background colour that ISO/IEC 18004 requires around every QR code: at least 4 modules wide on all four sides, or 2 modules for Micro QR. It is part of the symbol, not decoration — without it, scanners cannot reliably detect the finder patterns.

Source: https://useqr.app/docs/spec/quiet-zone-requirements · Last reviewed 2026-08-21 · UseQR is free forever, MIT licensed, no signup.

---

## The requirement

ISO/IEC 18004 defines the [quiet zone](/glossary/quiet-zone) as a region of background
colour surrounding the symbol on all four sides, with a minimum width of **4 modules** for
a full QR code and **2 modules** for [Micro QR](/glossary/micro-qr). It is listed among the
symbol's structural features — the same list as finder and timing patterns — not as a
layout recommendation. A QR code cropped to its dark modules is, by the standard's
definition, incomplete.

In physical units the requirement scales with module size. A version 5 code (37 modules)
printed at 3 cm has modules of about 0.81 mm, so the quiet zone must be at least
**3.2 mm** of clear background on every side. UseQR's renderer includes the 4-module
quiet zone by default in every export, so the margin survives even if a designer places the
file edge-to-edge.

## Why it exists

Finder detection works by streaming pixel runs and looking for the
[1:1:3:1:1 signature](/docs/spec/finder-patterns). That signature needs a light run
*before* the first dark ring and *after* the last one — otherwise the outer dark ring
merges optically with whatever sits next to it, and the ratio never appears. A dark page
border, a photo, body text, or a second QR code hard against the symbol all destroy the
runs the detector is looking for.

The quiet zone also protects thresholding. Cameras normalise exposure locally; a heavy
dark element beside the code shifts the local threshold and can push light modules near the
edge below it.

## How it fails in the real world

Quiet zone violations are among the most common reasons a technically valid code
[fails to scan](/docs/troubleshooting/qr-code-not-scanning-checklist), and they are almost
always introduced *after* generation:

- **Frames and CTA labels** drawn tight against the modules — keep decorative
  [frames](/docs/design/qr-code-frames-and-cta-labels) at least 4 modules out.
- **Dark backgrounds.** Placing a standard code on a dark layout without a light plate
  under it leaves no quiet zone at all — see
  [busy backgrounds](/docs/design/qr-code-on-a-busy-background).
- **Cropping in design tools.** Auto-trim removes "empty" margins; the empty margin was
  load-bearing. The same happens when a
  [printer crops to content](/docs/troubleshooting/qr-code-cropped-by-a-printer).
- **Bleed and trim.** A code placed near a cut edge can lose its margin to trim variance —
  budget for it in the [safe area](/docs/print/bleed-trim-and-safe-area-for-qr).
- **Tight table layouts** that butt two codes together; each code needs its own 4 modules.

## More than the minimum

Four modules is the floor, not the target. Extra margin costs nothing and buys tolerance
for trim error, shadows, and fingers holding the print. A practical rule for print: give
the code clear space equal to at least **10% of its printed width** on every side, and
never let anything darker than the background inside that band. When the design is done,
[verify the flattened artwork decodes](/validate) rather than the pristine original — the
quiet zone is exactly the kind of thing flattening loses.

## FAQ

### How big does a QR code quiet zone need to be?
At least 4 modules of background colour on every side for a standard QR code, 2 modules for Micro QR. In millimetres that is four times the module size — about 3.2 mm for a 3 cm version 5 code.

### Does a QR code need a white border?
It needs a border in the background colour — the same colour as the light modules. On a white page that is white; on a cream label it is cream. What matters is a contrast break around the symbol, at least 4 modules wide.

### What happens if the quiet zone is too small?
The scanner's finder detection fails because the outer dark ring of a finder pattern merges with adjacent artwork, so the 1:1:3:1:1 signature never appears. The code may still scan occasionally, but reliability drops sharply, especially in poor light.

### Is the quiet zone included in QR code size?
By the standard, yes — the quiet zone is part of the symbol. When sizing a code for a layout, reserve space for the modules plus the 4-module margin on each side, which adds roughly 20–40% to the footprint depending on version.

## Try it

- https://useqr.app/url
- https://useqr.app/validate
- https://useqr.app/size-calculator