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.