~WC - Print Configuration Label
Prints a label listing the printer's current configuration.
~WC prints the configuration label, the page an operator reads for a printer's
darkness, sensor type, network identity, ZPL mode, firmware version and memory
contents. It asks for the same information as ^HH, and puts it on media instead of on
the link, so it adds a page to the output.
Syntax
~WCSupport
Every documented parameter renders the same output Labelary produces.
Prints its own label rather than an answer to the host, unlike ^HH. The renderer prints that listing as a page ahead of the format carrying the command, wherever in the format it sits, and counts it in X-Total-Count. A second ~WC prints a second listing, each reporting the printer of its moment. ^PQ replicates the label alone. The listing reads the label size, ^PW, ^LH, ^LT, ^LS, ^CC, ^CT and ^CD from the format, and carries fixed values elsewhere. A ^PW ahead of the ~WC also centers the page in the print window and cuts the rest away. A ^POI ahead of it turns the page over (measured 2026-08-16). Only ~WC is a command. — not pinned by a test
Labelary renders this command.
Parameters
~WC takes no arguments.
Behavior
~WC is an immediate command, and the page order shows that. Measured on
2026-08-16:
^XA~WC^FO50,50^A0N,40,40^FDhi^FS^XZreturnsX-Total-Count: 2, and the configuration label comes first.^LFand^WDadd their pages after the current label instead.^XA~WC^XZalone returns one page, and so does a~WCwith no format.- A second
~WCprints a second listing, each reporting the printer of its moment.
The listing is a boxed report headed LABELARY, one line per setting: printer name,
darkness, label home, label size, print width, the caret, tilde and delimiter
characters, and clock offsets. The renderer prints it on the same leading page, and
reads the label size, ^PW, ^LH, ^LT, ^LS, ^CC, ^CT and ^CD from the
format. The other values are defaults, not a real printer's. A ^PW or ^POI ahead of it moves
the page. ^WC is not a command and prints nothing.
Known issues
Tested behavior
Differences from the specification
Labelary against the ZPL II guide
Where Labelary — our compatibility target — behaves differently from the printed specification.
- Labelary prints the configuration label as a page of its own, ahead of the format.
^XA~WC^FO50,50^A0N,40,40^FDhi^FS^XZreturnsX-Total-Count: 2, the listing first, and a~WCafter the field keeps that order (measured 2026-08-16). The guide gives no page count, and no printer stands behind the service, so the order and the fixed listing are both Labelary's reading. The renderer follows it. — not pinned by a test
zpl.tools against Labelary
Where our output differs from Labelary for the same input. These are the differences that break a migration.
- Labelary's listing reports the darkness of
~SD, the name of^KN, the language of^KLand the offsets of^SO. The renderer tracks none of those commands, so those four lines carry defaults here (measured 2026-08-16). Every other line agrees. — not pinned by a test
Example
A configuration label ahead of an ordinary one.
^XA
~WC
^FO50,50^A0N,40,40^FDConfiguration label first^FS
^XZ
Related commands
^HHConfiguration Label ReturnSends the printer's configuration back to the host as text.^WDPrint Directory LabelPrints a label listing the objects held in printer memory.^LFList Font LinksPrints a label listing the printer's font links.~HQHost QuerySends one of ten named printer reports back to the host.