Sign In
Developers
API QuickstartAPI ReferenceMCP ServerBulk GenerationWebhooksSDKs & ExamplesLimitsDirectPrint agent NewGitHub ActionVS Code extensionOn-Premise
Solutions
Logistics & ShippingE-CommerceERP & WMSManufacturingRetailHealthcare & LaboratoryAll solutionsAll ToolsGuidesPricing
Language
EnglishTürkçeDeutsch
Home›ZPL Lint Rules›ZPL lint rules

ZPL lint rules

The linter behind the viewer, the API, the CLI and the VS Code extension reports findings with a stable code. Each code has a page with a label that triggers it and the corrected label.

Structure

CodeSeverityFinding
ZPL0001ErrorMissing ^XA
ZPL0002ErrorMissing ^XZ
ZPL0003ErrorNested ^XA
ZPL0004Error^XZ without ^XA

Commands

CodeSeverityFinding
ZPL1001ErrorUnknown command
ZPL1002WarningCommand not supported by the renderer
ZPL1003ErrorUnknown command with a likely typo

Fields

CodeSeverityFinding
ZPL2001WarningField data not terminated with ^FS
ZPL2002InfoField without a position
ZPL2003WarningStored format has no ^FN fields

Numeric parameters

CodeSeverityFinding
ZPL3001WarningParameter is not a number
ZPL3002WarningParameter out of range

Barcodes

CodeSeverityFinding
ZPL4001WarningBarcode without data
ZPL4002WarningEAN-13 data is not 12–13 digits
ZPL4003WarningGS1 data without GS1 mode (no FNC1)
ZPL4004WarningGS1 check digit is wrong
ZPL4005WarningGS1 AI value has the wrong length
ZPL4006InfoGS1 check digit set by the printer
ZPL4007WarningNon-ASCII character in Code 128 data

Fonts and encoding

CodeSeverityFinding
ZPL5001Warning^CI code page other than 28
ZPL5002Warning^A@ font not downloaded
ZPL5003WarningInvalid orientation letter
ZPL5004WarningNon-ASCII text without ^CI28

Label bounds

CodeSeverityFinding
ZPL6001WarningField origin outside the label
ZPL6002WarningBarcode runs past the right edge
ZPL6003WarningBarcode runs past the bottom edge
ZPL6004Warning^PW wider than the selected label

Printer model

CodeSeverityFinding
ZPL7001WarningModel does not print at this resolution
ZPL7002WarningPrint width exceeds the model's printhead
ZPL7003WarningPrint speed above the model's maximum

Analyzer notes (no page)

ZPL9001 is added when the output was truncated at the finding limit and ZPL9002 when the time budget ran out. They describe the analysis run, not your label, so they have no page: fix the listed findings and run the linter again.

Lint your ZPL now