Qu’est-ce que ZPL ? Guide du langage Zebra pour débutants
Vous téléchargez une étiquette et voyez ^XA et ^FO à la place d’une image. C’est du ZPL : des instructions qu’une imprimante compatible transforme en texte, codes-barres et graphiques. Vous pouvez les lire et les prévisualiser avant d’envoyer quoi que ce soit à l’imprimante.

Qu’est-ce que ZPL ?
ZPL signifie Zebra Programming Language, un langage de commandes développé par Zebra pour les imprimantes d’étiquettes. Aujourd’hui, ZPL désigne généralement ZPL II, la version ultérieure documentée dans les manuels actuels. Il indique où placer le texte, quel code-barres dessiner et comment ajouter une image, pour les étiquettes d’expédition, de produits ou de stock.
Avec les préfixes par défaut, les commandes de format commencent par ^ et celles de contrôle par ~. Un format d’étiquette commence par ^XA et se termine par ^XZ. Ce sont des instructions, pas un PDF ni une photo : un moteur de rendu ou une imprimante compatible les interprète pour créer l’étiquette.
À quoi ressemble le ZPL ?
Cet exemple minimal place le mot Hello sur une étiquette. Copiez uniquement le bloc de code dans le visualiseur ; les explications restent séparées pour que le code soit directement utilisable.
^XA
^FO50,50
^A0N,40,40
^FDHello^FS
^XZ| Commande | Fonction |
|---|---|
^XA | Commence un nouveau format d’étiquette. |
^FO50,50 | Place l’origine du champ à x = 50, y = 50 points d’impression par rapport à l’origine de l’étiquette. |
^A0N,40,40 | Sélectionne la police 0, l’orientation normale (N) et une hauteur et largeur demandées de 40 points d’impression, pas 40 points typographiques. |
^FDHello^FS | ^FD fournit le texte Hello ; ^FS termine ce champ. |
^XZ | Termine le format d’étiquette. Pour ce travail simple, l’imprimante peut ensuite produire l’étiquette. |
Les positions et dimensions de police sont en points d’impression, pas en millimètres. À 203 DPI, 50 points représentent environ 6,3 mm ; à 300 DPI, environ 4,2 mm. Cet exemple suppose l’origine et l’orientation habituelles et ne règle ni dimensions, ni détection du support, ni calibration. Sélectionnez les dimensions et DPI réels dans le visualiseur et configurez l’imprimante séparément.
Qu’est-ce qu’un fichier .zpl ?
Un fichier .zpl habituel est du texte brut contenant ces commandes, parfois pour plusieurs étiquettes. L’extension indique l’usage prévu ; elle ne transforme pas le fichier en image. Ouvrez-le avec Bloc-notes, VS Code ou un autre éditeur de texte pour lire ses instructions.
Pour voir l’étiquette plutôt que le code, ouvrez le fichier dans un visualiseur ZPL. Enregistrez les modifications en texte brut, pas dans un document Word. Renommer un PDF en .zpl ne le convertit pas. Certains flux ZPL contiennent des données binaires de graphiques ou de polices : tous les travaux ne sont donc pas entièrement lisibles comme du texte.
Que peut-on faire avec ZPL ?
Commencez par l’exemple, puis choisissez l’outil pour votre prochaine étape. L’aperçu permet de vérifier la mise en page ; l’impression physique nécessite aussi une imprimante compatible, le bon support et une connexion fonctionnelle.
Afficher une étiquette
Ouvrez un fichier .zpl ou collez du code pour voir la mise en page sans imprimante.
Ouvrir le visualiseur ZPLModifier le modèle
Ajustez texte, positions et dimensions dans l’éditeur, puis vérifiez le résultat.
Ouvrir l’éditeur ZPLAjouter un logo
Transformez une image en données graphiques ZPL à insérer dans votre étiquette.
Convertir une image en ZPLPour les logos, ^GFA correspond à la commande de champ graphique ^GF avec A pour les données ASCII hexadécimales. Viennent ensuite les nombres d’octets, les octets par ligne et les données d’image encodées, pas un nom de fichier PNG. Le convertisseur prépare un graphique monochrome. ^BC produit des codes-barres Code 128 et ^BQ des codes QR.

Imprimer l’étiquette
Envoyez le ZPL comme instructions directes avec un logiciel ou utilitaire compatible, par exemple Zebra Setup Utilities pour les modèles pris en charge. Imprimer depuis un éditeur de texte peut imprimer le code lui-même. Vérifiez langage, dimensions et DPI, puis essayez une étiquette avant un lot. L’aperçu du navigateur n’établit pas de connexion avec l’imprimante.
Pourquoi l’imprimante imprime du code ou des caractères illisibles
ZPL et les autres langages d’imprimante
EPL et TSPL sont d’autres langages d’étiquettes avec des syntaxes différentes. Un appareil peut en accepter plusieurs grâce au firmware ou à l’émulation, mais renommer un fichier ne traduit pas ses commandes. Comparez ZPL et EPL avant de réutiliser un modèle sur une autre imprimante.
Questions fréquentes
ZPL est-il gratuit ou open source ?
Vous pouvez écrire du ZPL avec un éditeur de texte et consulter la documentation publique de Zebra. Cela ne fait pas de ZPL un projet logiciel open source. Les éditeurs, convertisseurs, polices et logiciels ont leurs propres licences et peuvent être gratuits ou payants.
Faut-il une imprimante Zebra ?
Aucune imprimante n’est nécessaire pour lire, modifier ou prévisualiser du ZPL. Pour l’impression directe, utilisez une Zebra ou un autre appareil prenant explicitement en charge les commandes nécessaires. L’émulation dépend du modèle et du firmware. Un export PDF peut être imprimé via un flux PDF.
Comment ouvrir un fichier .zpl ?
Utilisez un éditeur de texte pour lire les commandes ou ouvrez le fichier dans le visualiseur ZPL pour afficher l’étiquette. Choisissez les dimensions et DPI prévus pour un aperçu pertinent.
Quelle différence entre ZPL et ZPL II ?
ZPL II est la version ultérieure du ZPL original de Zebra. On l’abrège souvent en ZPL. Pour de nouveaux modèles, suivez la documentation ZPL II compatible avec votre appareil ; ne supposez pas que toutes les anciennes commandes ou tous les modes se comportent de manière identique.
Références officielles
À propos de l'auteur
Eduard Diaz
Eduard Diaz est technicien IT (développement) chez S-IE, un partenaire officiel Zebra avec plus de 20 ans de services d'identification et d'étiquetage. Il développe et maintient EditorZPL pour faciliter le travail avec le ZPL et les imprimantes d'étiquettes Zebra.
s-ie.cat