Référence des commandes ZPL et aide-mémoire
ZPLCraftMis à jour le 17 août 2026
Cette référence pratique présente les commandes ZPL II couramment utilisées pour la structure du format, le texte, les polices, les codes-barres, les graphiques et le contrôle de l’imprimante. Toutes les positions et tailles sont en points d'imprimante (203 dpi = 8 points/mm — voir Qu'est-ce que le ZPL ? pour les bases). Les paramètres indiqués dans la colonne syntaxe sont : x,y = position depuis le coin supérieur gauche, h,w = hauteur et largeur, o = orientation (N normal, R 90°, I 180°, B 270°).
Format d'étiquette
| Commande | Syntaxe | Fonction |
|---|---|---|
^XA | ^XA | Début d'un format d'étiquette. Chaque étiquette commence par cette commande. |
^XZ | ^XZ | Fin d'un format d'étiquette. L'imprimante rend et imprime l'étiquette à la réception de cette commande. |
^FX | ^FXcomment | Commentaire — ignoré par l'imprimante. À terminer par ^FS comme tout champ. |
^PW | ^PWwidth | Largeur d'impression en points. Définissez cette valeur sur la largeur de votre étiquette pour éviter que les champs soient coupés. |
^LL | ^LLlength | Longueur de l'étiquette en points. Nécessaire principalement pour les supports en continu (sans espace). |
^LH | ^LHx,y | Origine de l'étiquette — décale l'origine pour toutes les positions ^FO suivantes. |
^PQ | ^PQqty | Quantité d'impression — nombre de copies de cette étiquette à imprimer. |
^PR | ^PRspeed | Vitesse d'impression en pouces par seconde. Une vitesse plus lente produit souvent une impression plus noire et plus nette. |
^MD | ^MDdarkness | Ajustement de la noirceur du support, de -30 à 30. Augmentez si l'impression est trop claire. |
Champs et texte
| Commande | Syntaxe | Fonction |
|---|---|---|
^FO | ^FOx,y | Origine du champ — positionne le prochain champ à x,y points depuis l'origine de l'étiquette. |
^FD | ^FDdata | Données du champ — le contenu (texte ou données de code-barres) du champ courant. |
^FS | ^FS | Séparateur de champ — ferme le champ courant. Obligatoire après chaque champ. |
^FB | ^FBwidth,lines,space,align | Bloc de champ — insère le texte ^FD dans un bloc : largeur maximale, nombre de lignes maximal, interligne, alignement (L/C/R/J). |
^FR | ^FR | Champ inversé — imprime le champ en blanc sur noir là où il chevauche une zone noire. |
^FH | ^FH | Champ hexadécimal — permet les séquences _xx dans ^FD, ex. _C3_A9 pour é. |
^CI | ^CIencoding | Jeu de caractères ; ^CI28 sélectionne UTF-8 et est recommandé pour tout texte non-ASCII. |
Polices
| Commande | Syntaxe | Fonction |
|---|---|---|
^A | ^Afo,h,w | Police pour le prochain champ : lettre de police f (0–9, A–Z), orientation, hauteur et largeur en points. ^A0N,40,40 est la police vectorielle scalable par défaut à 40 points. |
^CF | ^CFf,h,w | Modifie la police par défaut pour tous les champs suivants qui ne définissent pas leur propre ^A. |
^A@ | ^A@o,h,w,name | Utilise un fichier de police stocké sur l'imprimante (ex. TrueType téléchargé). |
La police 0 est la police vectorielle scalable et le choix habituel ; les polices A–H sont des polices bitmap à taille fixe qui ne s'affichent correctement qu'à leurs tailles natives ou à des multiples entiers.
Codes-barres
| Commande | Syntaxe | Fonction |
|---|---|---|
^BY | ^BYw,r,h | Paramètres par défaut du code-barres : largeur du module (barre étroite) en points, ratio large/étroit, hauteur par défaut. À définir avant la commande de code-barres. |
^BC | ^BCo,h,f,g,e,m | Code 128 — le code-barres 1D de référence pour l'expédition et la logistique. f=Y imprime la ligne lisible par l'homme, g=Y l'imprime au-dessus du code. |
^B3 | ^B3o,e,h,f,g | Code 39 — ancienne symbologie 1D encore requise par certaines spécifications industrielles et de défense. |
^BE | ^BEo,h,f,g | Code-barres EAN-13 pour la vente au détail (utilisez ^BU pour UPC-A). |
^BQ | ^BQa,model,mag,ec | QR code. La magnification 1–10 définit la taille du module ; ec définit la correction d'erreur (H/Q/M/L). Préfixez les données avec le mode d'encodage, ex. ^FDQA,https://… |
^BX | ^BXo,h,s,c,r,f | Data Matrix — code 2D compact courant sur les étiquettes électroniques et de santé. |
^B7 | ^B7o,h,m,c,r,t | PDF417 — code 2D empilé utilisé sur les cartes d'identité et certains documents logistiques. |
Le dimensionnement d’un code-barres dépend de la symbologie. Utilisez ^BY pour définir la largeur du module, le rapport et la hauteur, puis suivez la spécification applicable de la symbologie, du transporteur ou du secteur pour les dimensions minimales et les zones de silence. Un aperçu ne remplace pas la vérification de l’impression physique avec le scanner et le support de production.
Graphiques
| Commande | Syntaxe | Fonction |
|---|---|---|
^GB | ^GBw,h,t,c,r | Rectangle graphique : largeur, hauteur, épaisseur du bord, couleur (B/W), arrondi des coins 0–8. Un ^GB fin permet de tracer des lignes. |
^GC | ^GCd,t,c | Cercle graphique de diamètre d et d'épaisseur de bord t. |
^GD | ^GDw,h,t,c,o | Ligne diagonale graphique dans un cadre w×h ; o définit la direction (L ou R). |
^GF | ^GFa,b,c,d,data | Champ graphique — intègre un bitmap (ex. un logo) directement dans l'étiquette sous forme de données hexadécimales ou binaires. |
~DG | ~DGd:name,t,w,data | Téléchargement de graphique — stocke une image sur l'imprimante, puis la place avec ^XG. |
^XG | ^XGd:name,mx,my | Rappel d'un graphique stocké à l'origine du champ courant, avec une magnification x/y. |
Contrôle et état de l'imprimante
| Commande | Syntaxe | Fonction |
|---|---|---|
~HS | ~HS | État de l'hôte — l'imprimante répond avec des informations sur le manque de papier, la pause, le tampon et l'odomètre. |
~HI | ~HI | Identification de l'hôte — modèle, version du firmware, DPI et mémoire. |
^MM | ^MMmode | Mode d'impression : T arrachage, P décollage, R rembobinage, C coupeuse. |
^MN | ^MNtype | Suivi du support : Y détection espace/web, M marque noire, N continu. |
~JC | ~JC | Lancer la calibration du support (l'imprimante avance quelques étiquettes pour trouver l'espace). |
~JA | ~JA | Annuler tous les formats d'étiquettes dans le tampon de l'imprimante. |
^JUS | ^JUS | Sauvegarder les paramètres courants en flash pour qu'ils survivent à une coupure de courant. |
Tout assembler
Une étiquette d'expédition type 4×6 utilisant la plupart des groupes ci-dessus :
^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
^XZModifier manuellement des coordonnées en points devient vite fastidieux — chaque ajustement de mise en page implique de changer des chiffres et de réimprimer. Si vous préférez faire glisser les champs à la bonne position et laisser le ZPL s'écrire seul, l'éditeur ZPLCraft ci-dessous compile un canevas visuel vers exactement ce type de ZPL propre, et peut l’envoyer par une voie USB compatible entre le navigateur et l’imprimante lorsque le navigateur, le système d’exploitation et l’imprimante proposent une interface disponible.