Glossary Term

QR Code Quiet Zone

glossary qr code quiet zone featured

A QR code quiet zone is the blank margin around a QR code, at least four modules wide on every side, that must contain no text, graphics, or pattern. Scanners use it to find where the code ends and the surrounding design begins. The quiet zone is part of the QR code specification, ISO/IEC 18004, not an optional design choice.

Why the Quiet Zone Matters

A scanner locates a QR code by its three square finder patterns in the corners. It needs a clean, light band around them to tell the code apart from everything else on the page. When text, a photo, or a frame touches the code, the scanner may read those marks as extra modules and fail to decode.

The failure is easy to miss. The code scans on the designer’s phone held close in good light, then fails on a poster across a room or on a glossy box under shop lighting. A cropped quiet zone is one of the most common reasons a correctly generated code stops working after layout.

QR Code Quiet Zone Size

The quiet zone is measured in modules, the small squares that make up the code, not in millimetres or pixels. Its width scales with the code.

Symbol Minimum quiet zone Source
QR code 4 modules on all sides ISO/IEC 18004
Micro QR code 2 modules on all sides ISO/IEC 18004
Rectangular Micro QR (rMQR) 2 modules on all sides ISO/IEC 23941

To size it in print, multiply the module size by four:

Quiet zone per side = module size x 4
Total width = (modules across + 8) x module size

Version 2 code, 25 x 25 modules, 0.5 mm modules:
Quiet zone = 0.5 x 4 = 2 mm per side
Total width = (25 + 8) x 0.5 = 16.5 mm

A 25-module code needs 33 modules of space once the margin is counted. Denso Wave, which invented the QR code, states that a QR code “requires a four-module wide margin at all sides of a symbol.” The full print-size math, including how URL length changes module count, is in the guide to QR code smallest size.

QR Code Margin vs QR Code Border

“Margin”, “border”, and “quiet zone” usually describe the same blank space, but generators and designers use the words differently.

  • Margin or border setting. QR libraries expose the quiet zone as a number of modules. Python’s qrcode library calls it border and defaults to 4, “the minimum according to the specs”. The Node.js qrcode package calls it margin, also default 4.
  • Decorative frame. A drawn outline or a “Scan me” frame is not a quiet zone. It is a printed mark, so it must sit outside the four-module margin, never against the code.
import qrcode
qr = qrcode.QRCode(border=4)  # 4 modules of quiet zone; never set lower for print

ISO/IEC 18004 also requires the quiet zone to match the light modules in reflectance. A pale grey or patterned background counts as a marking, not as blank space.

Common Quiet Zone Mistakes

  • Cropping in layout. The code is placed with its bounding box trimmed to fit a tight column.
  • Transparent PNG on a dark page. The file has a margin, but it is transparent, so the dark background becomes the quiet zone.
  • Text or logos crowding the edge. Captions, arrows, and icons placed within four modules.
  • Busy backgrounds. Photos, gradients, or textures running behind the margin.
  • Packaging edges. Folds, seams, and die-cuts that cut into the margin after printing.

Many phone cameras still read a code with a narrower margin under good conditions, but results vary by app, distance, and lighting. Four modules is the margin that holds across all of them.

Frequently Asked Questions

How big should the quiet zone be on a QR code?

At least four modules wide on all four sides of a standard QR code. A module is one square of the code, so the quiet zone grows with the code’s printed size. Micro QR and rMQR codes need only two modules.

Does the quiet zone have to be white?

No, but it must match the light modules of the code. If the code uses cream light modules, the quiet zone must be the same cream. Light modules on a dark background (an inverted code) are a separate problem: many scanners do not read them at all.

Can you put a logo or text inside the quiet zone?

No. Anything printed in the quiet zone can be read as part of the code. Place logos in the center of the code with a higher error correction level, and place text outside the four-module margin.

Does a QR code need a quiet zone on a screen?

Yes. Screens cause the same problem as print when a code sits on a dark page, a busy image, or a video. Export the code with a solid light margin rather than a transparent one.

Generate codes with the quiet zone built in using linkutm’s QR codes feature, then test the final layout on more than one phone before printing.

Back to Glossary