ZPL0001 — Missing ^XA

A ^ command appears before any ^XA. Everything outside a format is not part of a label: printers ignore it and the preview has nothing to draw.

Label that triggers it

^FO50,50^A0N,40^FDHELLO^FS

Finding: ZPL0001 · line 1:1 — Missing ^XA — the label format never starts

Open the broken label in the editor →

How to fix it

Start the format with ^XA before the first command. The editor offers the insertion as a quick-fix when the document has no ^XA at all.

Corrected label

^XA^FO50,50^A0N,40^FDHELLO^FS^XZ

Open the corrected label in the editor

Commands involved

^XA

Related rules

ZPL0002 Missing ^XZ · ZPL0003 Nested ^XA · ZPL0004 ^XZ without ^XA

In CI

npx labelixa validate "labels/**/*.zpl" lints your files and prints this page's address next to each finding. /docs/cli

Lint your ZPL now