ZPLToolkit

^LT

Label TopPreview: partial

Offsets all following field origins vertically, providing a format-wide up/down print adjustment in dots.

Syntax

^LTa

Parameters

ParameterDescription and accepted valuesIf omitted
aVertical shift in dots; positive moves down and negative moves up.-120 to 120 dots from the top0

How it works

^LT changes the vertical placement of later fields. It is commonly used to compensate a small top-of-label registration difference after the media and sensor calibration are already correct.

The value is in dots, so it must be scaled for printhead resolution just like ^FO coordinates. A positive adjustment moves the image down; a negative adjustment is appropriate only after checking that it will not clip the top of the printable area.

^LT is a global adjustment for the format. When only one address line is too low, edit that field's coordinate instead of moving every barcode, graphic and text line beneath it.

Example

ZPL
^XA
^LT30
^FO40,30^A0N,40,40^FDShifted down^FS
^XZ

Rendering…

The field starts at y=30, and ^LT30 moves its printed position 30 dots down.
Open in the viewer

How the preview on this site handles it

The preview applies ^LT to the vertical position of later fields. It does not simulate media calibration, sensor timing or printer-specific permanent settings.

Common mistakes

  • Using ^LT to hide a calibration problem. The apparent correction can fail as soon as media or darkness settings change.
  • Moving the label up until the first field is clipped. Check the true printable top margin after a negative adjustment.
  • Forgetting that the number is dots. Recalculate it when the template moves from 203 dpi to 300 dpi.

See also