Referência de Comandos ZPL — Cheat Sheet para Zebra
Atualizado em 11 de junho de 2026
Esta é uma referência funcional dos comandos ZPL II que cobrem a grande maioria das etiquetas reais: estrutura do formato, texto, fontes, códigos de barras, gráficos e controle da impressora. Todas as posições e tamanhos são em pontos da impressora (203 dpi = 8 pontos/mm — veja O que é ZPL? para o básico). Os parâmetros mostrados na coluna de sintaxe são: x,y = posição a partir do canto superior-esquerdo, h,w = altura e largura, o = orientação (N normal, R 90°, I 180°, B 270°).
Formato da etiqueta
| Comando | Sintaxe | O que faz |
|---|---|---|
^XA | ^XA | Início do formato de etiqueta. Toda etiqueta começa com este comando. |
^XZ | ^XZ | Fim do formato de etiqueta. A impressora renderiza e imprime a etiqueta ao receber este comando. |
^FX | ^FXcomment | Comentário — ignorado pela impressora. Encerre-o com ^FS como qualquer campo. |
^PW | ^PWwidth | Largura de impressão em pontos. Defina com a largura da sua etiqueta para que os campos não sejam cortados. |
^LL | ^LLlength | Comprimento da etiqueta em pontos. Necessário principalmente para mídia contínua (sem gap). |
^LH | ^LHx,y | Origem da etiqueta — desloca a origem para todas as posições ^FO subsequentes. |
^PQ | ^PQqty | Quantidade de impressão — quantas cópias desta etiqueta imprimir. |
^PR | ^PRspeed | Taxa de impressão (velocidade) em polegadas por segundo. Mais lento geralmente imprime mais escuro e nítido. |
^MD | ^MDdarkness | Ajuste de escuridão de mídia, -30 a 30. Aumente se a impressão estiver fraca. |
Campos e texto
| Comando | Sintaxe | O que faz |
|---|---|---|
^FO | ^FOx,y | Origem do campo — posiciona o próximo campo em x,y pontos a partir da origem da etiqueta. |
^FD | ^FDdata | Dados do campo — o conteúdo (texto ou dados de código de barras) do campo atual. |
^FS | ^FS | Separador de campo — fecha o campo atual. Obrigatório após cada campo. |
^FB | ^FBwidth,lines,space,align | Bloco de campo — envolve o texto ^FD em um bloco: largura máxima, máximo de linhas, espaçamento, alinhamento (L/C/R/J). |
^FR | ^FR | Campo invertido — imprime o campo branco sobre preto onde se sobrepõe a uma área preta. |
^FH | ^FH | Campo hexadecimal — permite escapes _xx hex em ^FD, ex.: _C3_A9 para é. |
^CI | ^CIencoding | Conjunto de caracteres; ^CI28 seleciona UTF-8 e é recomendado para qualquer texto não-ASCII. |
Fontes
| Comando | Sintaxe | O que faz |
|---|---|---|
^A | ^Afo,h,w | Fonte para o próximo campo: letra da fonte f (0–9, A–Z), orientação, altura e largura em pontos. ^A0N,40,40 é a fonte escalável padrão com 40 pontos. |
^CF | ^CFf,h,w | Altera a fonte padrão para todos os campos seguintes que não definam seu próprio ^A. |
^A@ | ^A@o,h,w,name | Usa um arquivo de fonte armazenado na impressora (ex.: TrueType baixada). |
A fonte 0 é a fonte vetorial escalável e a escolha usual; as fontes A–H são fontes bitmap de tamanho fixo que só ficam corretas em seus tamanhos nativos ou múltiplos inteiros.
Códigos de barras
| Comando | Sintaxe | O que faz |
|---|---|---|
^BY | ^BYw,r,h | Padrões de campo de código de barras: largura do módulo (barra estreita) em pontos, proporção largo-estreito, altura padrão. Defina antes do comando de código de barras. |
^BC | ^BCo,h,f,g,e,m | Code 128 — o código de barras 1D de referência para envio e logística. f=Y imprime a linha legível por humanos, g=Y a imprime acima do código. |
^B3 | ^B3o,e,h,f,g | Code 39 — simbologia 1D mais antiga ainda exigida por algumas especificações industriais e de defesa. |
^BE | ^BEo,h,f,g | Código de barras EAN-13 de varejo (use ^BU para UPC-A). |
^BQ | ^BQa,model,mag,ec | QR code. Ampliação 1–10 define o tamanho do módulo; ec define a correção de erro (H/Q/M/L). Prefixe os dados com o modo de codificação, ex.: ^FDQA,https://… |
^BX | ^BXo,h,s,c,r,f | Data Matrix — código 2D compacto comum em etiquetas de eletrônicos e saúde. |
^B7 | ^B7o,h,m,c,r,t | PDF417 — código 2D empilhado usado em documentos de identidade e alguns documentos logísticos. |
Para um código de barras legível, acerte três coisas: largura de módulo (^BY primeiro parâmetro) de pelo menos 2–3 pontos a 203 dpi, uma zona de silêncio de ~10 larguras de módulo em cada lado, e altura suficiente (um código de barras 1D abaixo de ~50 pontos é difícil de ler com scanners manuais).
Gráficos
| Comando | Sintaxe | O que faz |
|---|---|---|
^GB | ^GBw,h,t,c,r | Caixa gráfica: largura, altura, espessura da borda, cor (B/W), arredondamento dos cantos 0–8. Um ^GB fino é como você desenha linhas. |
^GC | ^GCd,t,c | Círculo gráfico com diâmetro d e espessura de borda t. |
^GD | ^GDw,h,t,c,o | Linha diagonal gráfica dentro de uma caixa w×h; o define a direção (L ou R). |
^GF | ^GFa,b,c,d,data | Campo gráfico — incorpora um bitmap (ex.: um logotipo) diretamente na etiqueta como dados hex ou binários. |
~DG | ~DGd:name,t,w,data | Download de gráfico — armazena uma imagem na impressora, depois posiciona-a com ^XG. |
^XG | ^XGd:name,mx,my | Recupera um gráfico armazenado na origem do campo atual, com ampliação x/y. |
Controle e status da impressora
| Comando | Sintaxe | O que faz |
|---|---|---|
~HS | ~HS | Status do host — a impressora responde com informações de falta de papel, pausa, buffer e odômetro. |
~HI | ~HI | Identificação do host — modelo, versão de firmware, DPI e memória. |
^MM | ^MMmode | Modo de impressão: T tear-off, P peel-off, R rewind, C cutter. |
^MN | ^MNtype | Rastreamento de mídia: Y gap/web sensing, M black-mark, N contínua. |
~JC | ~JC | Executa calibração de mídia (a impressora avança algumas etiquetas para encontrar o gap). |
~JA | ~JA | Cancela todos os formatos de etiqueta no buffer da impressora. |
^JUS | ^JUS | Salva as configurações atuais na flash para que sobrevivam a um ciclo de energia. |
Juntando tudo
Uma etiqueta típica estilo envio 4×6 usando a maioria dos grupos acima:
^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
^XZEditar coordenadas de pontos à mão cansa rápido — cada ajuste de layout significa mudar números e reimprimir. Se você prefere arrastar os campos para o lugar certo e deixar o ZPL se escrever sozinho, o editor ZPLCraft abaixo compila um canvas visual para exatamente este tipo de ZPL limpo, e pode imprimir pelo navegador via USB.
Para detalhes exaustivos parâmetro a parâmetro além deste cheat sheet, a fonte oficial é o ZPL II Programming Guide da Zebra, disponível gratuitamente no site de suporte da Zebra.