ZPLToolkit

^FS

Field SeparatorPreview: exact

Ends the current field. Every field needs one, and a missing ^FS makes the rest of the label print as part of it.

Syntax

^FS

This command takes no parameters.

How it works

^FS closes the field that is being built and tells the printer to commit it. Until it arrives, the printer keeps treating incoming data as part of the current field.

That is why a missing ^FS is so destructive: the next ^FO does not start a new field, it is read while the previous one is still open, and the label comes out with fields merged, overlapping or missing entirely. The failure is rarely local to the line that caused it.

^FS takes no parameters. It closes text fields, barcode fields, ^GB boxes and ^GF graphics alike, and it optionally closes an ^FX comment.

Example

ZPL
^XA
^FO40,40^A0N,35,35^FDFirst field^FS
^FO40,110^A0N,35,35^FDSecond field^FS
^XZ

Rendering…

Two independent fields, each closed by its own ^FS.
Open in the viewer

How the preview on this site handles it

Fully supported. ^FS is the point at which the preview actually draws the field it has been assembling.

Common mistakes

  • Omitting ^FS on one field. The damage shows up further down the label, not where the mistake is.
  • Writing ^FS before ^FD. The field closes with no data and prints nothing.
  • A stray ^FS with no open field. Harmless on the printer, but usually a sign that a template was concatenated wrongly.

See also