Was ist ZPL? Die Zebra-Programmiersprache erklärt

ZPLCraft · Aktualisiert am 17. August 2026

ZPL (Zebra-Programmiersprache) ist die Befehlssprache, die Zebra- und Zebra-kompatible Thermodrucker zur Beschreibung von Etiketten verwenden. Statt eines fertigen Bildes erhält ein ZPL-Drucker einen kurzen Block aus Klartextbefehlen, interpretiert diese und rendert das Etikett mit der konfigurierten Druckkopfauflösung.

ZPL verwendet kompakte Textbefehle, die Anwendungen wie ERP-Systeme, Skripte und Browser-Tools erzeugen können. Die Druckerunterstützung hängt von Modell und Konfiguration ab: Zebra dokumentiert ZPL II in den Spezifikationen der jeweiligen Modelle, und einige Drucker anderer Hersteller bieten einen dokumentierten ZPL-kompatiblen Emulationsmodus.

So sieht ein ZPL-Etikett aus

Ein ZPL-Dokument ist eine Folge von Befehlen, die jeweils mit einem Zirkumflex (^) beginnen. Jedes Etikett ist eingeschlossen zwischen ^XA (Formatstart) und ^XZ (Formatende). Hier ein vollständiges, lauffähiges Etikett:

^XA
^CF0,40
^FO50,50^FDHELLO WORLD^FS
^FO50,110^GB700,4,4^FS
^BY3,2,100
^FO150,150^BCN,100,Y,N,N^FD12345678^FS
^XZ

Zeile für Zeile gelesen:

• ^XA … ^XZ — öffnet und schließt das Etikettenformat. Alles dazwischen beschreibt ein Etikett.
• ^CF0,40 — setzt die Standardschrift auf die skalierbare Schrift 0 mit 40 Punkten Höhe.
• ^FO50,50 — Feldursprung: positioniert das nächste Feld 50 Punkte vom linken und 50 Punkte vom oberen Rand.
• ^FDHELLO WORLD^FS — Felddaten gefolgt von Feldtrennzeichen: der tatsächliche Inhalt des Feldes.
• ^GB700,4,4 — zeichnet einen Grafikrahmen 700 Punkte breit und 4 Punkte hoch — hier als horizontale Linie verwendet.
• ^BY3,2,100 dann ^BCN,100,Y,N,N — setzt Barcode-Standardwerte (Modulbreite, Verhältnis, Höhe), rendert dann einen Code 128-Barcode mit den Daten 12345678 und einer lesbaren Zeile darunter.

Punkte, keine Pixel: DPI verstehen

Jede Koordinate und Größe in ZPL wird in Druckerpunkten gemessen, und die physische Größe eines Punktes hängt von der Druckkopfauflösung ab. Die gängigen Auflösungen sind 203 dpi (8 Punkte/mm), 300 dpi (12 Punkte/mm) und 600 dpi (24 Punkte/mm). Auf einem 203-dpi-Drucker ist ein 4 × 6 Zoll großes Versandetikett 812 × 1218 Punkte; auf einem 300-dpi-Drucker dasselbe Etikett 1200 × 1800 Punkte. ZPL, das für eine Auflösung geschrieben wurde, druckt auf einer anderen kleiner oder größer. Eine abweichende DPI ist daher eine häufige Ursache für „Mein Etikett sieht auf dem neuen Drucker falsch aus"; Größen müssen auf die Ziel-DPI skaliert werden.

ZPL vs. EPL vs. treiberbasierter Druck

Sie werden möglicherweise auch auf EPL (Eltron Programming Language), das von einigen älteren oder ausdrücklich kompatiblen Druckern verwendet wird. Die Unterstützung für ZPL und EPL variiert je nach Modell und Firmware; prüfen Sie daher vor der Wahl einer Sprache die Herstellerdokumentation. Als Alternative zur direkten Ausgabe einer Druckersprache können Sie treiberbasierten Druck verwenden. Dabei bereitet ein Windows- oder CUPS-Treiber eine gerenderte Seite für den konfigurierten Drucker auf. Rohes ZPL kann direkte Koordinatensteuerung und kompakte Textdaten bieten, während treiberbasierter Druck geeigneter sein kann, wenn das Gerät oder Betriebssystem keinen kompatiblen Roh-ZPL-Pfad bereitstellt.

ZPL schreiben — oder generieren

Für ein einmaliges Etikett ist das manuelle Schreiben von ZPL mit einer Befehlsreferenz gut machbar: die Sprache ist überschaubar, und eine Handvoll Befehle (^FO, ^FD, ^A, ^BC, ^GB) deckt die meisten realen Etiketten ab. Mühsam wird es, wenn Sie ein Layout iterieren müssen — jede Feinkorrektur bedeutet Punktkoordinaten ändern, die Datei neu senden und Etikettenfolie verschwenden.

Dieses Problem lösen visuelle Editoren. ZPLCraft bietet eine maßstabsgetreue Arbeitsfläche, auf der Sie Text, Barcodes, Linien und Rahmen positionieren und ZPL für die gewählte Drucker-DPI erzeugen. Barcode-Daten, Abmessungen und Ruhezonen müssen weiterhin die Anforderungen der gewählten Symbologie erfüllen; prüfen Sie den Ausdruck mit dem vorgesehenen Drucker und Scanner. Sie können den Code in ein System exportieren, das bereits ZPL sendet, oder WebUSB-Druck aus dem Browser verwenden , wenn Browser, Betriebssystem und Drucker eine kompatible, beanspruchbare Schnittstelle bereitstellen.

Häufig gestellte Grundfragen

Ist ZPL kostenlos nutzbar?

Zebra veröffentlicht das ZPL-II-Programmierhandbuch als öffentlich zugängliche Referenz, und ZPL-Befehle lassen sich mit einem Texteditor schreiben. Für Druckersoftware, Schriftarten, Firmware und Marken können eigene Lizenzbedingungen gelten.

Welche Dateiendung verwendet ZPL?

Es gibt keine vorgeschriebene Endung — ZPL ist Klartext. In der Praxis sieht man .zpl, .txt und .prn; Druckern ist das egal, sie verarbeiten einfach den Bytestrom.

Kann ich ZPL ohne Drucker in der Vorschau anzeigen?

Ja — Rendering-Dienste wie Labelary wandeln ZPL in ein Bild um, und der ZPLCraft-Editor zeigt eine Live-Vorschau des Etiketts während des Designs, sodass Sie Etikettenfolie erst verbrauchen, wenn das Layout fertig ist.

Welche Drucker sind ZPL-kompatibel?

Die Kompatibilität hängt von Modell und Konfiguration ab. Prüfen Sie die Herstellerangaben auf ZPL- oder ZPL-II-Unterstützung beziehungsweise einen dokumentierten Emulationsmodus, bestätigen Sie die Ziel-DPI und benötigten Funktionen und testen Sie den konkreten Ausgabeweg. Eine USB-Verbindung oder TCP-Port 9100 allein beweist nicht, dass ein Drucker ZPL akzeptiert. Kompatibilität und Empfehlung