ZPLToolkit

^XF

Recall FormatPreview: partial

Recalls a named stored format and fills its numbered fields with data in the current print job.

Syntax

^XFd:o.x

Parameters

ParameterDescription and accepted valuesIf omitted
d:o.xDevice, stored format name and extension to recall.Device, name and .ZPL extension of the stored formatR:FORMAT.ZPL

How it works

^XF inserts a stored format at the recall point. The surrounding job supplies ^FN field data, so repeated labels can reuse one downloaded layout instead of transmitting every static command again.

The local preview can expand a recall when the matching ^DF template is included in the same paste. A name that exists only in printer memory remains intentionally partial: the browser has no honest copy to draw.

Values may be supplied before or after ^XF in the pasted format. Keep their ^FN numbers explicit and close each binding with ^FS to avoid confusing template data with ordinary text fields.

Example

ZPL
^XA
^DFR:RECIPIENT.ZPL^FS
^PW320^LL200^FO40,60^A0N,30,30^FN1^FS
^XZ
^XA
^XFR:RECIPIENT.ZPL^FS
^FN1^FDRecipient^FS
^XZ

Rendering…

A stored recipient format recalled with its one numbered value.
Open in the viewer

How the preview on this site handles it

The preview expands only templates supplied in the same document. A missing or recursive recall produces a warning and draws no invented layout.

Common mistakes

  • Assuming a browser can see a template left on a printer by an earlier job.
  • Passing data under a field number the template does not use.
  • Creating a template that recalls itself or another template in a loop.

See also