How to create a QR code in ZPL

What a ZPL QR code contains

A QR code stores text in a two-dimensional matrix. In a label workflow that text is often a URL, a product identifier, a tracking value or contact details. ZPL sends the instructions to the printer; the printer creates the modules at print time.

The ^BQ command is the ZPL command for QR symbols. It defines the orientation, model and magnification, while ^FD supplies the data. Start with a short, realistic payload and keep a quiet zone of white space around the symbol.

The basic ^BQ syntax

A compact example is shown below. ^FO positions the symbol, ^BQN selects a QR code, 2 selects the common QR model and 6 is the magnification factor. The LA prefix tells the printer to use automatic error correction for the following data.

The ^FS terminator closes the field and ^XZ ends the label format. Keep each command together while debugging so you can distinguish a positioning problem from an invalid payload.

^XA
^FO60,60^BQN,2,6^FDLA,https://editorzpl.com^FS
^XZ

Choose size, DPI and error correction

QR modules are printed dots, so the same magnification produces different physical sizes at 203, 300 and 600 DPI. A value that scans on a desktop preview may be too small on the real label. Match the viewer DPI to the target printer and measure the printed symbol.

Leave a clear quiet zone on every side and avoid placing the symbol against a border or textured background. Higher error correction helps when labels may be scratched, but it also makes the symbol denser. Increase the symbol size before shrinking the quiet zone.

Prepare the data before encoding it

URLs, plain text and identifiers work well. For a URL, use the final HTTPS address and keep it short so the QR remains easy to scan. If a system requires Wi-Fi, vCard or another format, generate the exact payload required by that format and test it independently.

Do not paste unescaped control characters or an accidental line break into ^FD. Test accented characters and long values with the same firmware and code page as production. The QR generator can help you inspect the payload before you put it into a label template.

Preview and print a real sample

Paste the example into the ZPL viewer, select the physical label size and choose the printer DPI. The preview is useful for checking placement, rotation and overall density, but it cannot prove that a scanner will read the physical ink.

Print one sample on the final stock and scan it with at least two devices. Check the shortest and longest expected values, contrast, quiet zone, orientation and distance. If the symbol fails, increase magnification and review the data before changing several variables at once.

Common QR problems in ZPL

A QR that does not scan is usually too small, too dense, low contrast or cropped by the label edge. A missing quiet zone, a wrong rotation or a printer configured at a different DPI can have the same symptom. Verify the actual printed dimensions instead of judging only the browser preview.

If the printer reports an invalid command, check firmware support for ^BQ and confirm that the format starts with ^XA and ends with ^XZ. Keep a known-good short URL as a control sample, then add the production data once the geometry is confirmed.