Guides / Print and packaging

QR codes on labels and thermal printers

Label printers print in a grid of dots. When each QR module lines up with a whole number of those dots, codes come out crisp. When it doesn't, modules print unevenly and scanning suffers.

2 min readPrint and packaging
On this page Match the code to the printer's dots Sending the code to the printer Direct thermal vs thermal transfer Label tips Questions
In short
  • Make each module a whole number of printer dots.
  • At 203 DPI, aim for 4 dots (0.5 mm) per module.
  • Thermal transfer lasts; direct thermal fades.

Match the code to the printer's dots

Thermal printers usually print at 203 DPI (8 dots per millimeter) or 300 DPI (about 12 per millimeter). A module that's 3.5 dots wide can't be printed; the printer rounds some modules up and some down, and the code looks uneven.

PrinterOne dotGood module sizes
203 DPI0.125 mm3 dots (0.375 mm), 4 dots (0.5 mm), 5 dots (0.625 mm)
300 DPI0.085 mm5 dots (0.42 mm), 6 dots (0.51 mm), 7 dots (0.59 mm)

Multiply by the number of modules to get the code width. A 25×25 code with a 4-module border is 33 modules, so at 4 dots per module on a 203 DPI printer it's 132 dots, or 16.5 mm.

Make a label code with square dots, which print cleanest on thermal printers.

Make a label code

Sending the code to the printer

Direct thermal vs thermal transfer

Direct thermalThermal transfer
How it printsHeat darkens special paperHeat melts ink from a ribbon
LifespanMonths; fades with heat and sunlightYears
Best forShipping labels, receiptsProduct labels, assets, outdoor use

Label tips

Questions

What size QR code can a thermal printer print?

At 203 DPI, about 1.5 to 2 cm wide for a short link, with each module 4 printer dots (0.5 mm).

Why do QR codes from my label printer look uneven?

The module size isn't a whole number of printer dots. Resize the code so each module is exactly 3, 4 or 5 dots wide.