Sign In
Products
ZPL ViewerBarcode GeneratorImage → ZPLZPL cheat sheetLabel DesignerTemplate Gallery
Developers
API QuickstartAPI ReferenceMCP ServerBulk GenerationWebhooksSDKs & ExamplesLimitsDirectPrint agent NewGitHub ActionVS Code extensionOn-Premise
Solutions
Logistics & ShippingE-CommerceERP & WMSManufacturingRetailHealthcare & LaboratoryAll solutions
Tools
ZPL Diagnostics HubZPL DebuggerSize & DPI AnalyzerDPI ConverterBarcode fit calculatorShipping Label AnalyzerFont InspectorOrientation DebuggerCalibration AssistantPrinter Compatibility CheckerBarcode Readability CheckerPrinter Language DetectorThermal Printer Test PackZPL ToolsEPL ToolsTSPL ToolsCPCL ToolsPrinter Language ConverterAll ToolsGuidesPricing
Language
EnglishTürkçeDeutsch
Home›ZPL Lint Rules›ZPL7003

ZPL7003 — Print speed above the model's maximum

^PR sets a print speed higher than the selected model's published maximum at this resolution. The ZPL manual is explicit that the printer accepts the value and prints at its own maximum, so the setting has no effect: it does not make that printer faster. Letter codes count too (A=2, B=3, C=4, D=6, E=8 ips). Speed limits come from Zebra's spec sheets and user guides for each model.

SeverityWarning
CategoryPrinter model

Label that triggers it

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

This finding depends on the selected printer model, not on the code alone. The API call that produces it:

curl -X POST "https://api.labelixa.com/v1/diagnostics?model=ZQ521&dpmm=8" \
     --data "^XA^PR12^FO50,50^A0N,40^FDHELLO^FS^XZ"

Finding: ZPL7003 · line 1:4 — ^PR print speed 12 ips exceeds ZQ521's maximum (5 ips) — the printer clamps it to its maximum and does not print any faster

How to fix it

Set ^PR to the model's maximum or lower. Lower speeds often give darker, sharper barcodes on direct thermal media. The example is clean with ^PR5 on a ZQ521.

Corrected label

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

The same label is clean with this call:

curl -X POST "https://api.labelixa.com/v1/diagnostics?model=ZQ521&dpmm=8" \
     --data "^XA^PR5^FO50,50^A0N,40^FDHELLO^FS^XZ"

ZPL7001 Model does not print at this resolution · ZPL7002 Print width exceeds the model's printhead

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