Paste code or load the sample — the result appears below, with the line and severity of each finding.
2Result
Health report
The label comes out of the printer noticeably smaller than the
media — a 4×6 shipping label fills only about two-thirds of the sheet, with a
wide white margin on the right and bottom. Nothing in the ZPL changed. What
changed is the printer.
Why the same ZPL prints smaller
ZPL measures everything in printer dots, not millimetres.
^PW812 does not mean "4 inches"; it means "812 dots, whatever a
dot happens to be on this printer". On a 203 DPI head a dot is 1/203 of an
inch, so 812 dots are 4 inches. On a 300 DPI head the same 812 dots are
only 2.7 inches — the layout shrinks to about 68% of its intended size, every
element in proportion.
That is why the symptom appears after a printer swap: the file was authored
for a 203 DPI workhorse (GK420, ZD420 and friends), and it now lands on a
300 DPI model. The printer is not broken and the ZPL is not corrupt; the
two simply disagree about the size of a dot.
Confirm it in sixty seconds
Open the ZPL and find ^PW (width in dots) and ^LL
(length in dots). Divide each by the two candidate resolutions:
^PW812 ^LL1218
812 / 203 = 4.0 in 1218 / 203 = 6.0 in ← a standard 4x6
812 / 300 = 2.7 in 1218 / 300 = 4.1 in ← not a standard size
If the numbers only make sense at 203 DPI and your printer is a
300 DPI model, you have found the cause. If the file has no
^PW/^LL at all, the printer falls back to its own
defaults and the output varies from machine to machine — add explicit
dimensions first, then judge the size.
The fix: rescale the dots, not the printer
Multiply every dot value by the resolution ratio — for 203→300 that is
×1.5: coordinates (^FO/^FT), label size
(^PW/^LL), font heights (^A) and barcode
module widths (^BY). Scaled together, the label regains its
physical size and barcodes keep their ratio. Doing this by hand is error-prone
in any real template; a converter that applies the ratio to every command at
once turns it into a one-step job — the
203 to 300 dpi converter does exactly
that and lists anything it could not scale.
Two honest limits. Embedded bitmap graphics (^GF,
~DG) carry fixed pixels — scaling their numbers would mean
inventing image data, so a logo should be re-exported from the original
artwork at the new resolution. And no conversion can be proven correct on
screen alone: print one sample and scan the barcodes before a production run.
Why ^MU did not fix it
The command most people try first is ^MUd,200,300: "this
format was written for 200 dpi, convert it to 300". Zebra's ZPL
Programming Guide defines it that way — a format base of 150, 200 or
300 dpi and a target of 300 or 600 dpi. In practice it disappoints
for three reasons:
It only scales up. There is no target below 300, so a
file written for 300 dpi cannot be shrunk for a 203 dpi printer with
^MU.
It only affects the commands after it. Placed below
^PW, ^LL or the first ^FO, it leaves
those values unscaled — part of the label converts, part does not.
It does not touch embedded bitmaps (^GF,
~DG); a logo keeps its original pixel size.
The scaling happens inside the printer, so no on-screen preview can show
it: Labelixa's preview flags ^MU and draws the label without it.
Rewriting the dot values in the file gives a label that looks the same in the
preview and on every printer.
Which resolution is the printer, really?
The sixty-second check assumes you know the head's DPI — and that is the
assumption that fails most often, because a 300 DPI unit looks identical
to its 203 DPI twin. Three places tell you: the model name in the
printer's web page or on the chassis label carries the suffix
(ZT610-300dpi, ZD621-203dpi); the configuration label
(hold Feed, or send ^XA^WC^XZ) prints a RESOLUTION
line in dots per millimetre — 8/mm is 203 DPI, 12/mm is 300, 24/mm is
600; and the maximum ^PW the
printer accepts is a fingerprint of its head:
Head
Dots per mm
4-inch head, max
^PW
A 4×6 label is
203 DPI
8
832
^PW812 ^LL1218
300 DPI
12
1248
^PW1200 ^LL1800
600 DPI
24
2496
^PW2400 ^LL3600
If the file's ^PW is far below the head's maximum while the
label fills the media width, the mismatch is confirmed. The
size analyzer reads both numbers from
the file and reports the physical size at each candidate resolution; the
^MU page lists what that command
can and cannot rescale. The opposite symptom — a 300 DPI file on a
203 DPI head, 1.5× too large and clipped at the edge — has its own
guide: ZPL label cut off.
When it is not the resolution
If the maths above says the size should be right, look at the spots between
the file and the head: a Windows driver set to "shrink to fit" or to the wrong
stock size, or a label template whose fields simply sit in the top-left
quarter (small content, correct canvas — the analyzer output
distinguishes the two by showing both the declared size and the field
extents). Media calibration affects where the label starts, not how large the
layout prints.
Frequently asked questions
Why does my Zebra label suddenly print too small?
Almost always a resolution mismatch: the ZPL was written for a 203 DPI printer and now runs on a 300 DPI one. ZPL measures in dots, and 812 dots are 4 inches at 203 DPI but only 2.7 inches at 300 DPI, so the whole layout shrinks proportionally.
How do I check which DPI my ZPL file was written for?
Divide ^PW and ^LL by each candidate resolution. If 812x1218 dots gives a standard size like 4x6 inches only at 203 DPI, the file was authored for 203 DPI. If the file has no ^PW/^LL, add explicit dimensions before judging the size.
Can I just change a printer setting instead of the file?
No setting makes a 300 DPI head treat 812 dots as 4 inches. The dot values themselves must be rescaled (x1.5 for 203 to 300) — coordinates, label size, fonts and barcode module widths together — and embedded ^GF/~DG images re-exported at the new resolution.
How do I know whether my Zebra printer is 203 or 300 DPI?
Three places: the model name on the printer's web page or chassis label ends in -203dpi or -300dpi; the configuration label prints a RESOLUTION line in dots per mm (8/mm = 203 DPI, 12/mm = 300, 24/mm = 600); and a 4-inch head accepts at most ^PW832 at 203 DPI but ^PW1248 at 300 DPI.
