ZPLToolkit

^FN

Field NumberPreview: partial

Marks a field by number so a stored format can receive its data when the printer recalls it.

Syntax

^FNn

Parameters

ParameterDescription and accepted valuesIf omitted
nIdentifier of the field in the stored format.0 to 9999 — field number0

How it works

^FN gives a field a stable number inside a stored format. A later recall can supply the matching value without resending the layout around it.

Use unique numbers for each variable field in one template. The number is a binding point, not visible ink by itself; position, font and surrounding field commands still belong in the template.

Close the numbered field with ^FS. Keep the data pairing close to the ^XF recall so a reader can see which value fills which placeholder.

Example

ZPL
^XA
^FO40,60^A0N,40,40^FN1^FS
^XZ

Rendering…

A numbered placeholder inside a field position.
Open in the viewer

How the preview on this site handles it

The preview expands numbered fields only when the same pasted document includes a matching ^DF template and ^XF recall. An unbound ^FN has no visible output.

Common mistakes

  • Reusing one number for two unrelated values.
  • Expecting ^FN alone to print text.
  • Forgetting the closing ^FS for the numbered field.

See also