ZPLToolkit

^LS

Label ShiftPreview: partial

Offsets all following field origins horizontally, providing a format-wide left/right print adjustment in dots.

Syntax

^LSa

Parameters

ParameterDescription and accepted valuesIf omitted
aHorizontal shift in dots; positive moves right and negative moves left.-9999 to 9999 dots from the left0

How it works

^LS adds a horizontal shift to field placement. It is the right adjustment when the entire printable image is consistently left or right of the stock's intended margin, while ^FO remains the tool for a single field.

The value is in dots and can be negative. Measure it at the actual printer resolution: a 40-dot adjustment is 5 mm at 8 dpmm but only about 3.4 mm at 12 dpmm.

Because it moves later fields as a group, keep it near the start of a format and document why it exists. A hidden ^LS deep in a template makes every downstream coordinate harder to understand.

Example

ZPL
^XA
^LS40
^FO20,60^A0N,40,40^FDShifted right^FS
^XZ

Rendering…

The field starts at x=20, and ^LS40 moves its printed position 40 dots right.
Open in the viewer

How the preview on this site handles it

The preview applies ^LS to the horizontal position of later fields. It does not change the source coordinates shown in the example, only their rendered placement.

Common mistakes

  • Using ^LS to repair one field. It shifts every later field, including graphics and barcodes.
  • Copying a dot offset to a printer with another resolution. Convert the physical correction first.
  • Putting ^LS after fields that should have moved. Placement is determined as fields are processed.

See also