ZPL Commando Referentie — Spiekbriefje voor Zebra Printers

Bijgewerkt 11 juni 2026

Dit is een werkende referentie voor de ZPL II-commando's die de overgrote meerderheid van echte etiketten dekt: opmaakstructuur, tekst, lettertypen, barcodes, afbeeldingen en printerbesturing. Alle posities en afmetingen zijn in printerdots (203 dpi = 8 dots/mm — zie Wat is ZPL? voor de basisprincipes). Parameters in de syntaxiskolom zijn: x,y = positie vanuit de linkerbovenhoek, h,w = hoogte en breedte, o = oriëntatie (N normaal, R 90°, I 180°, B 270°).

Labelopmaak

CommandoSyntaxisWat het doet
^XA^XABegin van een labelopmaak. Elk etiket begint met dit commando.
^XZ^XZEinde van een labelopmaak. De printer rendert en print het etiket wanneer dit wordt ontvangen.
^FX^FXcommentOpmerking — genegeerd door de printer. Sluit het af met ^FS zoals elk veld.
^PW^PWwidthPrintbreedte in dots. Stel dit in op je labelbreedte zodat velden niet worden afgeknipt.
^LL^LLlengthLabellengte in dots. Voornamelijk nodig voor doorlopend (zonder-gap) media.
^LH^LHx,yLabel home — verschuift de oorsprong voor alle volgende ^FO-posities.
^PQ^PQqtyAfdrukshoeveelheid — hoeveel exemplaren van dit etiket worden afgedrukt.
^PR^PRspeedPrintsnelheid in inches per seconde. Langzamer print vaak donkerder en scherper.
^MD^MDdarknessMedia-duisternis aanpassing, -30 tot 30. Verhoog dit als het afdruk vaag is.

Velden en tekst

CommandoSyntaxisWat het doet
^FO^FOx,yVeldoorsprong — positioneer het volgende veld op x,y dots van de label home.
^FD^FDdataVelddata — de inhoud (tekst of barcodedata) van het huidige veld.
^FS^FSVeldscheidingsteken — sluit het huidige veld. Vereist na elk veld.
^FB^FBwidth,lines,space,alignVeldblok — wikkelt ^FD-tekst in een blok: maximale breedte, maximale regels, regelafstand, uitlijning (L/C/R/J).
^FR^FRVeld omgekeerd — print het veld wit op zwart waar het een zwart gebied overlapt.
^FH^FHVeld hexadecimaal — staat _xx hex-escapes toe in ^FD, bijv. _C3_A9 voor é.
^CI^CIencodingTekenset; ^CI28 selecteert UTF-8 en wordt aanbevolen voor niet-ASCII tekst.

Lettertypen

CommandoSyntaxisWat het doet
^A^Afo,h,wLettertype voor het volgende veld: lettertype-letter f (0–9, A–Z), oriëntatie, hoogte en breedte in dots. ^A0N,40,40 is het schaalbare standaardlettertype op 40 dots.
^CF^CFf,h,wWijzig het standaardlettertype voor alle volgende velden die geen eigen ^A instellen.
^A@^A@o,h,w,nameGebruik een lettertypebestand opgeslagen op de printer (bijv. gedownload TrueType).

Lettertype 0 is het schaalbare vectorlettertype en de gebruikelijke keuze; lettertypen A–H zijn vaste-grootte bitmaplettertypen die er alleen goed uitzien op hun native grootten of gehele veelvouden.

Barcodes

CommandoSyntaxisWat het doet
^BY^BYw,r,hStandaarden voor barcodes: modulebreedte (smalle balk) in dots, breed-naar-smal verhouding, standaardhoogte. Stel in vóór het barcodecommando.
^BC^BCo,h,f,g,e,mCode 128 — de veelgebruikte 1D-barcode voor verzending en logistiek. f=Y print de leesbare regel, g=Y print deze boven de code.
^B3^B3o,e,h,f,gCode 39 — oudere 1D-symbologie die nog vereist is door sommige industriële en defensiespecificaties.
^BE^BEo,h,f,gEAN-13 retailbarcode (gebruik ^BU voor UPC-A).
^BQ^BQa,model,mag,ecQR-code. Vergroting 1–10 stelt de modulegrootte in; ec stelt foutcorrectie in (H/Q/M/L). Prefix de data met de coderingsmodus, bijv. ^FDQA,https://…
^BX^BXo,h,s,c,r,fData Matrix — compacte 2D-code veel gebruikt op elektronica- en zorgetiketten.
^B7^B7o,h,m,c,r,tPDF417 — gestapelde 2D-code gebruikt op ID's en sommige logistieke documenten.

Voor een scanbarebarcode, zorg voor drie dingen: een modulebreedte (^BY eerste parameter) van minimaal 2–3 dots bij 203 dpi, een stille zone van ~10 modulebreedten lege ruimte aan beide kanten, en voldoende hoogte (een 1D-barcode onder ~50 dots is moeilijk te lezen voor draagbare scanners).

Afbeeldingen

CommandoSyntaxisWat het doet
^GB^GBw,h,t,c,rGrafisch kader: breedte, hoogte, randdikte, kleur (B/W), hoekafronding 0–8. Een dunne ^GB is hoe je lijnen tekent.
^GC^GCd,t,cGrafische cirkel met diameter d en randdikte t.
^GD^GDw,h,t,c,oGrafische diagonale lijn in een w×h kader; o stelt de richting in (L of R).
^GF^GFa,b,c,d,dataGrafisch veld — sluit een bitmap (bijv. een logo) direct in het etiket in als hex- of binaire data.
~DG~DGd:name,t,w,dataAfbeelding downloaden — sla een afbeelding op in de printer, plaats deze vervolgens met ^XG.
^XG^XGd:name,mx,myHerroep een opgeslagen afbeelding op de huidige veldoorsprong, met x/y-vergroting.

Printerbesturing en status

CommandoSyntaxisWat het doet
~HS~HSHoststatus — de printer antwoordt met papier-op, pauze, buffer- en kilometerteller-informatie.
~HI~HIHostidentificatie — model, firmwareversie, DPI en geheugen.
^MM^MMmodePrintmodus: T scheurmodus, P peel-off, R terugspoelen, C cutter.
^MN^MNtypeMediatracking: Y gap/web-sensing, M zwartmerk, N doorlopend.
~JC~JCVoer mediacalibratie uit (de printer voert een paar etiketten in om de gap te vinden).
~JA~JAAnnuleer alle labelopmaakindelingen in de printerbuffer.
^JUS^JUSSla huidige instellingen op in flash zodat ze een stroomuitval overleven.

Alles samenvoegen

Een typisch 4×6 verzendlabel-stijl met de meeste bovenstaande groepen:

^XA
^PW812
^CI28
^CF0,32

^FO40,40^FDSHIP TO:^FS
^FO40,80^A0N,44,44^FDAcme Industries^FS
^FO40,130^FD500 Warehouse Way^FS
^FO40,170^FDSpringfield, IL 62701^FS

^FO40,230^GB732,3,3^FS

^FO40,260^FDOrder #A-10592 / 3 of 4^FS

^BY3,2,120
^FO140,320^BCN,120,Y,N,N^FD4210159200083^FS
^XZ

Met de hand dot-coördinaten bewerken wordt snel vervelend — elke opmaakwijziging betekent nummers aanpassen en opnieuw afdrukken. Als je liever de velden op hun plek sleept en de ZPL zichzelf laat schrijven, compileert de ZPLCraft-editor hieronder een visueel canvas naar precies dit soort schone ZPL, en kan het vanuit de browser via USB printen.

Voor uitgebreide parameter-voor-parameter details voorbij dit spiekbriefje is de gezaghebbende bron Zebra's officiële ZPL II Programmeerhandleiding, gratis beschikbaar op Zebra's supportsite.