Module

Also called: cell, dot, QR code pixel

Definition

A module is one square cell of a QR code, dark or light. It is the basic unit of the symbol: every size, margin and print rule for a QR code is measured in modules.

Reviewed by the AriaQR Team ·

Watch the episode · 2:08QR Code Minimum Size: How Small Can a QR Code Be? (The 10:1 Rule)
Module: a QR code with a 5 × 5 patch magnified to show one square cell
One module is one cell of the grid. This version 2 code is 25 modules wide.

What a module is

A module is the smallest square in a QR code grid, and each one is either dark or light. A dark module usually stands for a binary 1 and a light module for a 0, although masking flips many of them before printing, so you cannot read the data by eye.

Modules are arranged in a square grid whose side length depends on the version. Version 1 is 21 modules wide and each version above it adds 4 modules per side, up to 177 modules for version 40.

Why modules are the unit of measure

The standard describes almost everything in modules rather than millimeters, because a QR code can be printed at any size. The quiet zone is 4 modules wide, a finder pattern is 7 by 7 modules, and an alignment pattern is 5 by 5 modules.

When you plan a print job, the physical width of one module is what matters to the scanner. A camera has to resolve each module as a distinct square, so a code with many small modules needs to be printed larger or scanned from closer than a code with fewer, bigger modules.

  • Version 1: 21 × 21 modules
  • Version 10: 57 × 57 modules
  • Version 40: 177 × 177 modules
  • Micro QR M1: 11 × 11 modules

Module shape and styling

The standard draws modules as squares, but readers sample the center of each cell, so rounded squares, dots and other shapes often still scan. The safer the design, the more of each module’s center area stays solid and the higher the contrast between dark and light.

Styling works best on data modules and is riskier on the finder patterns, which scanners rely on to locate the code. Testing a styled code on several phones is the only reliable check.

Module: the same code drawn with square, rounded and dot modules, all scannable
Square, rounded and dot modules: readers sample the centre of each cell, so all three scan.

Frequently asked questions

How big should one module of a QR code be when printed?

A common rule of thumb is at least 0.3 to 0.5 mm per module for close-range scanning on packaging or cards, and larger for anything read from a distance. The exact figure depends on the camera, the distance and the print quality.

Are QR code modules always square?

In the standard they are square, but many readers tolerate rounded or dot-shaped modules because they sample the middle of each cell. Always test a styled code before printing it.

How many modules does a QR code have?

It depends on the version. The side length is 17 plus 4 times the version number, so version 1 has 21 × 21 modules and version 40 has 177 × 177.

Sources and standards

All terms