Anmelden
Produkte
ZPL-ViewerBarcode-GeneratorBild → ZPLZPL-SpickzettelEtiketten-DesignerVorlagen-Galerie
Entwickler
API-SchnellstartAPI-ReferenzMCP-ServerMassenerzeugungWebhooksSDKs & BeispieleLimitsDirectPrint-Agent NeuGitHub ActionVS-Code-ErweiterungOn-Premise
Lösungen
Logistik und VersandE-CommerceERP & WMSProduktionEinzelhandelGesundheitswesen und LaborAlle Lösungen
Tools
ZPL-DiagnosezentrumZPL-DebuggerGrößen- und DPI-AnalyseDPI-KonverterBarcode-PlatzrechnerVersandetiketten-AnalyseSchriftprüfungAusrichtungs-DebuggerKalibrierungsassistentDruckerkompatibilitätsprüfungBarcode-LesbarkeitsprüfungDruckersprachen-ErkennungThermodrucker-TestpaketZPL-ToolsEPL-ToolsTSPL-ToolsCPCL-ToolsDruckersprachen-KonverterAlle WerkzeugeRatgeberPreise
Sprache
EnglishTürkçeDeutsch
Startseite›Ratgeber›Was ist ZPL?

Was ist ZPL?

Veröffentlicht: · Aktualisiert:

ZPL (Zebra Programming Language) ist der übliche Weg, einem Thermo-Etikettendrucker zu sagen: „Druck das, und zwar hier." Sie senden keine Bilddatei, sondern Text — gezeichnet wird im Drucker.

Das Gerüst eines ZPL-Etiketts

Jedes Etikett beginnt mit ^XA und endet mit ^XZ. Alles dazwischen gehört zu diesem Etikett. Das kleinste sinnvolle Etikett sieht so aus:

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

Dieses Etikett im ZPL-Viewer öffnen →

Stück für Stück gelesen:

Punkte, dpmm und Etikettengröße

Koordinaten sind in ZPL Punkte, und die physische Größe eines Punktes hängt von der Druckdichte ab. Üblich sind 8 dpmm (203 dpi) und 12 dpmm (300 dpi). Dasselbe ZPL, das auf einem 8-dpmm-Drucker richtig aussieht, wird auf einem 12-dpmm-Drucker zu klein — dieselbe Punktzahl deckt weniger Millimeter ab. Das ist das häufigste „bei mir lief es"-Problem in ZPL.

^PW legt die Etikettenbreite fest, ^LL die Länge. Ohne beide greift der Drucker auf seine eigenen Standardwerte zurück und die Ausgabe unterscheidet sich von Gerät zu Gerät.

Die drei häufigsten Fehler

  1. Fehlendes ^FS. Das Feld wird nie geschlossen, die folgenden Befehle schreiben hinein — das Etikett wirkt „halb verschwunden".
  2. Feld außerhalb der Etikettengrenze. Überschreitet eine ^FO-Koordinate ^PW/^LL, wird der Inhalt stillschweigend abgeschnitten: der Drucker meldet keinen Fehler, er druckt es schlicht nicht.
  3. Falsche Barcode-Parameter. Jede Symbologie akzeptiert einen anderen Zeichensatz und andere Längen; EAN-13 zwölf Ziffern zu geben oder Code 39 einen Kleinbuchstaben erzeugt einen Barcode, der nicht gelesen wird.

Die sechs Befehle, die Sie zuerst brauchen — und wo jeder erklärt ist

ZPL lernt man nicht, indem man das ganze Programmierhandbuch liest. Sechs Befehle decken das Gerüst oben ab; jeder hat eine Referenzseite mit Syntax, Beispiel und dem, was unser Renderer daraus macht.

BefehlWas er tutReferenz
^XA … ^XZÖffnet und schließt ein Etikett ^XA
^FOFeldursprung in Punkten von der linken oberen Ecke ^FO
^ASchrift, Ausrichtung und Größe des nächsten Felds ^A
^FD / ^FSDie Daten eines Felds und sein Ende ^FD, ^FS
^PW / ^LLEtikettenbreite und -länge in Punkten ^PW, ^LL
^BCDer Code-128-Barcode der meisten Versand- und Produktetiketten ^BC

Von hier aus ist der übliche Weg: den ZPL-Spickzettel beim Schreiben offen halten, alles Weitere in der Befehlsreferenz nachschlagen, und wenn eine Datei auf dem Tisch landet, wie man eine ZPL-Datei öffnet und wie man ZPL an einen Netzwerkdrucker sendet lesen. Die Frage Punkte gegen Millimeter von oben hat mit gemessenen Zahlen ihren eigenen Leitfaden: Punkte, mm, Zoll und DPI-Migration. ZPL ist die Sprache von Zebra; TSC-Drucker sprechen TSPL, mobile Zebra-Drucker CPCL — der ZPL-Hub listet die Werkzeuge, die Drucker, die es ausführen, und die Vergleiche mit den anderen Sprachen.

Sehen, bevor gedruckt wird

Das Mühsame an ZPL ist, dass man für das Ergebnis normalerweise einen echten Drucker und eine Etikettenrolle braucht: ein Versuch, ein Etikett. Die Vorschau von Labelixa zeichnet das ZPL im Browser in echter Größe und zeigt strukturelle Probleme — überlaufende Felder, ein fehlendes ^FS — mit Zeilennummer an. Ohne Drucker.

Häufig gestellte Fragen

Ist ZPL auf jedem Zebra-Drucker gleich?

Die Sprache ist gemeinsam, das Ergebnis hängt aber von der Punktdichte des Druckers ab: Positionen sind in Punkten angegeben, dasselbe ZPL druckt auf einem 203-dpi- und einem 300-dpi-Drucker unterschiedlich groß.

Brauche ich einen Drucker, um ZPL zu lernen?

Nein. Ein Online-Viewer oder eine Rendering-API zeichnet das Etikett aus dem Code; ZPL lässt sich lesen, schreiben und korrigieren, bevor irgendein Drucker beteiligt ist.

Was bedeuten ^XA und ^XZ?

Sie öffnen und schließen ein Etikett. Alles dazwischen beschreibt dieses Etikett; Befehle außerhalb des Rahmens werden ignoriert — einer der häufigsten Anfängerfehler.

Ist ZPL ein Format oder eine Sprache?

Eine Sprache. ZPL beschreibt ein Etikett als Befehle, die der Drucker ausführt; dieselbe Datei kann daher auf verschiedenen Druckern unterschiedlich groß drucken — ein festes Format wie PNG könnte das nicht.

Welche ZPL-Befehle sollte ich zuerst lernen?

Sechs decken die meisten Etiketten ab: ^XA/^XZ als Rahmen, ^FO für die Position, ^A für Schrift und Größe, ^FD mit ^FS für die Daten, ^PW/^LL für die Etikettengröße und ^BC für einen Code-128-Barcode. Alles andere ist eine Variation davon.

Verwandte Ratgeber

Wie öffnet man eine ZPL-Datei?

Eine .zpl-Datei öffnet sich in jedem Texteditor, denn ZPL ist Klartext. Was die Datei enthält, wie man sie liest und wie man das beschriebene Etikett sieht.

Kann ChatGPT oder Claude ZPL rendern?

Sprachmodelle schreiben ZPL, sehen das gedruckte Etikett aber nicht. Wie ein Render- und Validierungswerkzeug die Lücke schließt — Browser, API oder MCP.

ZPL-Datei ohne Drucker in der Vorschau ansehen

Eine ZPL-Datei ist nur Text — das Etikett existiert erst, wenn etwas es zeichnet. Vier Wege, ein ZPL-Etikett ohne Drucker zu sehen und zu testen, auch in CI.

Einen ZPL-Etiketten-Viewer in die eigene Seite einbetten

Gerenderte ZPL-Etiketten per iframe in eigenen Seiten zeigen — ohne Servercode, ohne Bibliotheken. Wie das Embed funktioniert, das URL-Format und seine Grenzen.

Eigenen ZPL-Code testen →