ZPL QR Code Examples: ^BQN Size, Error Correction and Data Format

QR codes are a friendly way to put URLs, serial numbers, work order links, product lookup pages, Wi-Fi data, and compact metadata on a Zebra label. In ZPL, the command you will usually reach for is ^BQN.

This guide covers the practical pieces: where to place the QR code, how to size it, how to format data, and how to avoid a symbol that looks correct but scans poorly.

A minimal ZPL QR code

^XA
^PW812
^LL406
^FO60,60
^BQN,2,6
^FDLA,https://zplpreview.com/^FS
^FO260,90^A0N,34,34^FDScan for label tools^FS
^XZ

The ^FO command places the QR code. ^BQN defines the QR barcode. The data begins in ^FD. For many Zebra workflows, the LA, prefix is used before the actual data.

Understanding the size parameter

The second number in ^BQN,2,6 is commonly treated as the magnification factor. Larger values make the QR code easier to scan but use more label space. A tiny product label may need a smaller value, while a warehouse label can often afford a larger symbol.

^BQN,2,4  ; compact
^BQN,2,6  ; common starting point
^BQN,2,8  ; larger and easier to scan

If operators scan labels at arm's length, do not make the symbol too small. The safest setting is the smallest QR code that scans reliably on the real scanner and media.

Error correction and real labels

QR codes include error correction, but that does not mean they survive every label design. Avoid placing text, borders, or logos close to the symbol. Keep a quiet zone around the QR code. If the label uses thermal transfer ribbon, confirm that darkness does not make small modules bleed together.

Example: serial number lookup

^XA
^PW609
^LL406
^FO40,40^A0N,32,32^FDAsset: LAP-20491^FS
^FO40,90^BQN,2,5
^FDLA,https://example.com/assets/LAP-20491^FS
^FO210,128^A0N,24,24^FDScan for service history^FS
^XZ

This pattern works well for IT asset labels, maintenance labels, and internal inventory tags. Use the Barcode Generator when you want a quick starting point for barcode data and preview the full label before printing.

Example: work order with human fallback

^XA
^PW812
^LL609
^FO50,50^A0N,42,42^FDWork Order WO-839102^FS
^FO50,120^BQN,2,7
^FDLA,WO-839102|LINE-4|REPAIR|2026-06-05^FS
^FO330,160^A0N,30,30^FDWO-839102^FS
^FO330,205^A0N,24,24^FDLine 4 / Repair^FS
^XZ

Always include human-readable fallback text for production labels. If a scanner, network, or app is temporarily unavailable, operators still need enough information to continue.

QR code checklist

• Start with ^BQN,2,6 and adjust after real scanner testing.
• Keep a visible quiet zone around the QR code.
• Do not place borders or logos too close to the symbol.
• Use concise data when possible; long payloads create dense symbols.
• Preview the label at the correct DPI.
• Test on the same printer, media, and scanner used in production.

QR code ZPL is not difficult, but it rewards restraint. Place the symbol clearly, keep the data compact, protect the quiet zone, and make the label useful even when the scanner is not available.