ZPLToolkit

^SN

Serialized DataPreview: partial

Places a serial value that the printer can increment between labels in a print run.

Syntax

^SNv,i,z

Parameters

ParameterDescription and accepted valuesIf omitted
vInitial serial value shown on the first label.Initial serial value0
iIncrement for each subsequent label.Increment for each printed label1
zPrinter-side serial formatting option; the preview does not emulate it.Printer serial-format option (not previewed)Printer default

How it works

^SN supplies serialised field data. The initial value is the visible starting text, while the printer can apply the increment and serial formatting on later labels.

Use it where a sequence belongs to the printer workflow. If the application already owns numbering, ordinary ^FD data is easier to audit.

^SN is field data and still needs ^FS. It follows the active origin and font like ^FD.

Example

ZPL
^XA
^FO40,60^A0N,40,40^SN1001,1,Y^FS
^XZ

Rendering…

The preview shows the initial serial value 1001.
Open in the viewer

How the preview on this site handles it

The preview shows only the initial value. It does not emulate printer-side incrementing, serial formatting or multi-label state.

Common mistakes

  • Expecting one preview to prove later serial values.
  • Forgetting ^FS.
  • Mixing printer and application numbering without an owner.

See also