Gap vs Black Mark Calibration: Fix Labels That Drift or Skip

When a label prints too high, skips every few labels, or stops with half the next label already exposed, people often open the template and start moving ^FO coordinates. Sometimes that helps. Often it only hides the real problem: the printer does not know where one label ends and the next begins.

Calibration is not glamorous, but it is one of the quickest ways to separate a template issue from a media-sensor issue.

First identify the media

The printer cannot calibrate correctly if it is looking for the wrong signal.

• Gap labels have a visible gap or liner space between labels.
• Black-mark labels have a black timing mark on the back or underside.
• Continuous media has no label boundary; length must come from the template or driver.

If a black-mark roll is configured as gap media, you may get labels that feed unpredictably. If continuous media is treated as gap media, the printer may hunt for a gap that does not exist.

Useful ZPL calibration snippets

The Printer Calibration Helper can generate review-ready snippets for ZPL, EPL, TSPL, and CPCL. For Zebra ZPL, the idea often looks like this:

^XA
^MNY
^JUS
^XZ
~JC

For black-mark media, the media tracking command changes:

^XA
^MNM
^JUS
^XZ
~JC

Do a physical check before changing code

Before editing ^PW, ^LL, or coordinates, do a thirty-second physical inspection:

• Is the roll loaded against the media guides, not drifting side to side?
• Is the sensor path aligned with the gap or black mark?
• Is the sensor dirty with adhesive dust?
• Is the platen roller clean and evenly gripping the label?
• Does a feed test stop at the same position three times in a row?

How template size and calibration interact

Calibration finds the label boundary. The template still needs to describe the printable area. In ZPL, that usually means checking ^PW for label width and ^LL for label length. A calibrated printer can still clip a label if the template says the label is shorter than it really is.

^XA
^PW812   ; 4 inches at 203 dpi
^LL1218  ; 6 inches at 203 dpi
^FO50,50^A0N,32,32^FDCalibrated media, correct label size^FS
^XZ

A practical order of operations

When a line reports drifting labels, use this order:

1. Confirm the media type and physical loading.
2. Clean the sensor and platen.
3. Run calibration for the correct media type.
4. Print a simple test label.
5. Only then adjust template size or field coordinates.

This sequence prevents “template fixes” that break as soon as the roll changes.

A field example: drifting after a roll change

A common support story goes like this: the morning shift replaces a roll, the first label prints correctly, the second starts a few millimeters lower, and by the fifth label the barcode is partly on the gap. The template did not suddenly change. The media did. In that situation, previewing the ZPL is still useful for confirming ^PW and ^LL, but the real fix is usually sensor alignment or media calibration.

Print a tiny diagnostic label after calibration instead of testing with the full production template. If the feed position is stable on a simple label, then move back to the real ZPL. If it still drifts, keep investigating hardware and media before changing coordinates.

^XA
^PW812
^LL300
^FO40,40^A0N,30,30^FDCalibration test^FS
^FO40,100^GB720,2,2^FS
^XZ