zpl.tools
Fields

^FS - Field Separator

Ends the current field.

^FS closes a field. It commits what the preceding commands describe, and clears the field-scoped state so the next field starts from the label's defaults. Every field needs one. An omitted ^FS is not a syntax error: it merges two fields into one, and only the second survives.

Syntax

^FS

Alternate form: 0x0F.

Support

Supportedparsed: full · state: full · rendered: full

Every documented parameter renders the same output Labelary produces.

Labelary renders this command.

Parameters

^FS takes no arguments.

Behavior

^FS resets everything that belongs to one field:

  • the origin from ^FO or ^FT;
  • the font from ^A;
  • the block from ^FB;
  • the escape character from ^FH;
  • the inversion from ^FR;
  • the bar code element.

It does not reset the label-wide state — ^CF, ^BY, ^FW, ^LH, ^CI — which a format sets once near the top.

An omitted ^FS costs a field. Measured on 2026-07-30: in ^FO40,80^A0N,30,30^FDfirst^FO40,130^A0N,30,30^FDsecond^FS only second prints, because the second ^FD replaces the first within the same field. Two ^FD commands in one field behave the same way.

^XZ closes an open field, so the last ^FS of a format is redundant and the field still prints. Nothing else forgives a missing separator, so write it anyway.

The single control byte 0x0F (SI, Control-O) is an exact alternate for ^FS, and helps when a transport strips or rewrites the caret.

Tested behavior

Example

Three complete fields. Each ^FS is what allows the next ^FO to mean a new field rather than a correction to the last one:

^XA
^FO40,30^A0N,30,30^FDfirst field^FS
^FO40,80^A0N,30,30^FDsecond field^FS
^FO40,130^GB300,40,40^FS
^XZ

Open in viewer