ZPL Resources: Commands, Calibration and Zebra Drivers
ZPL is the native language of every Zebra printer. This reference covers the structure of a label, the most-used commands with examples, printing a test label, calibrating darkness and speed on ZD and ZT printers, and where to download the official drivers — from the team that configures these printers for customers across Latin America.
What Is ZPL and Why Should You Learn It?
ZPL (Zebra Programming Language) is the language Zebra printers use to describe a label: text, barcodes, lines and boxes. It is plain text — every instruction starts with ^ or ~ — and the printer interprets it directly, with no graphics driver in between. The current version, ZPL II, has been the de facto standard of industrial labeling for decades.
One format, your whole fleet
The same ZPL file prints on a desktop ZD421, an industrial ZT231 or a mobile ZQ600 Plus series unit. Just watch the resolution: at 203 dpi the printer works at 8 dots per mm, so coordinates shift on a 300 dpi head.
Frictionless integration
Anything that can produce text can print labels: an ERP, a WMS, a web app or a ten-line script. Just send the ZPL string to the printer over USB or, on a network, to TCP port 9100. That is why our P4 Warehouse WMS generates native ZPL — the label comes out identical in every facility.
Total control of the output
Unlike printing from Word or a PDF, ZPL gives you the exact dot position of every field, the barcode symbology and the copy count. The output is repeatable: the test label you approve today is exactly what tomorrow's three thousand labels will look like.
Anatomy of a ZPL Label: From ^XA to ^XZ
Every ZPL format lives between two commands: ^XA opens the label and ^XZ closes and prints it. In between, each field is positioned with ^FO, filled with ^FD and terminated with ^FS. All measurements are in dots: on a 203 dpi printer, a 4×6-inch label is 812 × 1218 dots.
^XA
^CI28
^PW812
^LL1218
^FO40,40^GB732,120,3^FS
^FO60,75^A0N,55,55^FDBARRDEGA S.A.^FS
^FO60,210^A0N,35,35^FDShip to: Panama City^FS
^FO60,265^A0N,35,35^FDOrder: 00012345^FS
^FO60,360^BCN,120,Y,N,N^FD00012345^FS
^FO540,360^BQN,2,6^FDQA,https://barrdega.com^FS
^PQ1
^XZ- ^CI28 switches the printer to UTF-8 encoding — essential whenever your data carries accented characters.
- ^PW812 and ^LL1218 declare the label width and length in dots (4×6 inches at 203 dpi).
- ^GB732,120,3 draws a 732 × 120-dot box with a 3-dot border as the label header.
- ^BCN,120,Y,N,N renders a Code 128 barcode 120 dots tall with the human-readable text underneath.
- ^BQN,2,6 prints a model 2 QR code at magnification 6; the QA, prefix in the ^FD sets error correction level Q with automatic input mode.
- ^PQ1 requests a single copy; change it to ^PQ50 and the printer repeats the format fifty times.
The ZPL Commands That Cover 90% of Labels
ZPL has hundreds of commands, but in practice about a dozen handle nearly any logistics or product label. Bookmark this table — it is the cheat sheet we use every day when building formats for customers.
| Command | What it does | Example |
|---|---|---|
| ^XA / ^XZ | Opens and closes the label format; everything else goes in between | ^XA ... ^XZ |
| ^FO | Field origin: x,y coordinates in dots from the top-left corner | ^FO50,100 |
| ^FD / ^FS | Field data (text or barcode content) and field separator that closes it | ^FDLot A-123^FS |
| ^A | Font, orientation and size in dots (height, width); font 0 is scalable | ^A0N,40,40 |
| ^BC | Code 128 barcode, the logistics standard: orientation, height, readable text | ^BCN,100,Y,N,N |
| ^BQ | QR code: model and magnification factor; data goes in the ^FD with the QA, prefix | ^BQN,2,6 |
| ^GB | Graphic box or line: width, height and border thickness in dots; height 2 draws a rule | ^GB600,2,2^FS |
| ^PW | Print width in dots; at 203 dpi, 812 dots equal 4 inches | ^PW812 |
| ^LL | Label length in dots; most useful on continuous media | ^LL1218 |
| ^PQ | Print quantity: number of copies of the format | ^PQ3 |
| ^CI28 | UTF-8 encoding: required for accented characters and international text | ^CI28 |
| ~SD | Print darkness on a 0–30 scale; the value is stored in the printer | ~SD20 |
| ^PR | Print rate in inches per second; lower speed, better quality | ^PR4 |
The complete reference is Zebra's ZPL II Programming Guide, free on zebra.com. But before you read seven hundred pages, try the table above: those thirteen commands build everything from a rack location label to a shipping label with a tracking QR code.
How to Print Your First Test Label
Copy this minimal format into a text file and save it as test.zpl. There are three ways to get it to the printer.
^XA
^CI28
^FO50,50^A0N,50,50^FDZPL Test - Barrdega^FS
^FO50,130^BCN,100,Y,N,N^FD123456^FS
^XZ1. With Zebra Setup Utilities
The most convenient route on Windows. Open the direct-communication tool, paste the ZPL and send it: the label prints instantly, and you can iterate on the design line by line without touching any host system.
2. Over the network, to port 9100
Every networked Zebra printer listens for raw data on TCP port 9100. Any system — a short script, your ERP or your WMS — can open a connection to the printer's IP address, stream the file and close it. No driver, no print queue.
3. From the driver or front panel
The ZDesigner Windows driver can print a test page from the printer properties dialog, and ZT models with a display include a configuration label in the menu. Useful for confirming the hardware and media respond before you debug your own format.
Calibrating a Zebra Printer: Media, Darkness and Speed
Most of the print-quality issues we are asked to fix are not hardware failures: they are printers that were never recalibrated after a media change, or darkness and speed settings mismatched to the label stock and ribbon in use.
Media calibration
Whenever you change label size or type, the printer has to relearn where one label ends and the next begins. On ZD desktop models you run it with the FEED-button sequence from your model's manual, or with one click from Zebra Setup Utilities; on industrial ZT models, from the sensors menu on the front panel. If the printer is skipping blank labels or tearing mid-format, this is the first remedy to apply.
Darkness
The scale runs from 0 to 30 and is set with the ~SD command, from the driver or from the panel. Start mid-range and step up two at a time until the barcode is solid black and crisp. Too much darkness fattens the bars, distorts QR codes and shortens printhead life; too little produces faint print that scanners reject.
Print speed
Slower speed means more printhead contact time and sharper output — especially on synthetic materials and resin ribbons. If a critical label does not scan on the first pass, drop the speed with ^PR or in the driver before changing anything else. The golden rule: the lowest darkness and the highest speed that still scan every time.
The media matters as much as the settings
No calibration can compensate for the wrong label-and-ribbon pairing. If your labels smudge, fade or peel, check the consumable first: our label material guide explains how to choose it, and we supply genuine Zebra labels and ribbons certified for every printhead.
Common Symptoms and How to Fix Them
Before you open a support ticket, run through this table — it resolves most cases in minutes.
| Symptom | Likely cause | What to do |
|---|---|---|
| Faint or gray print | Darkness too low or speed too high for the media | Raise darkness (~SD) two steps at a time and reduce speed (^PR) |
| Blank labels come out, or the tear position drifts | Sensors uncalibrated after a media change | Run media calibration from the panel, the driver or Zebra Setup Utilities |
| Text or barcode clipped at the edge | ^PW or ^LL do not match the physical label | Recalculate width and length in dots for the printer's actual dpi |
| Accented characters print as garbage | Wrong character encoding | Add ^CI28 at the top of the format and save the file as UTF-8 |
| Barcode will not scan | Insufficient height, missing quiet zone or poor print quality | Increase the ^BC height, leave clear margins on both sides and slow the print down |
| Vertical white lines down the label | Dirty printhead or burned-out elements | Clean the printhead with isopropyl alcohol; if the line persists, it is time to replace it |
Drivers and Tools: Where to Download Them
All the official software is free from Zebra's support and downloads page. These are the four pieces we recommend installing.
Zebra Setup Utilities
The Swiss-army knife: it discovers the printer over USB or network, configures connectivity, triggers calibration and — most valuable for anyone writing ZPL — lets you send commands straight to the device and read its responses. It is the first tool we install on every deployment.
ZDesigner Windows driver
Needed when printing from office applications or systems that do not produce their own ZPL. It exposes darkness, speed and label size as printing preferences, so operators can adjust settings without touching code.
ZebraDesigner
A visual label editor: drag in fields, barcodes and logos, then print through the driver without writing a line of ZPL. The free Essentials edition covers simple formats; for variable-data designs you will move to code or professional labeling software.
NiceLabel / Loftware
When labeling becomes a corporate function — centralized templates, approvals, dozens of printers across multiple sites — the next level is NiceLabel by Loftware, which we design and implement as an authorized partner.
ZPL in Production: Wired Into Your WMS or ERP
A test label is the beginning; the real value arrives when the system prints on its own. The usual pattern is a ZPL template with placeholders that the software fills with each transaction's data — SKU, lot, order, destination — and sends to the right printer over port 9100. No operator intervention.
That is how P4 Warehouse works — the WMS built by our sister company P4 Software. It generates native ZPL for location, pallet, product and shipping labels, sent directly to any Zebra printer in the warehouse. And because we are also a Zebra ISV, the format, the printer and the system arrive tested as a single package.
Still choosing the hardware? Our Zebra printer buying guide compares the desktop and industrial models, and the full catalog shows every line available with delivery across Latin America.