Convert ZPL to TSPL: command equivalents and migration guide (Zebra → TSC)

How ZPL commands map to TSPL, what changes in units, fonts and barcodes, a real before/after label, and how to migrate a Zebra label library to TSC printers without redesigning.

Cet article est disponible en anglais et en espagnol.

Moving from Zebra to TSC is the most common printer migration in logistics and retail: TSC units cost less and the mechanics are compatible with the same labels and ribbons. The obstacle is the language. ZPL and TSPL describe the same things — a text at a position, a barcode, a box — with completely different syntax, so every existing ZPL template has to be rewritten unless something translates it for you.

Command equivalents

Operation	ZPL (Zebra)	TSPL (TSC)
Start / end of label	^XA … ^XZ	CLS … PRINT 1
Label size	^PW800 ^LL600 (dots)	SIZE 100 mm,75 mm GAP 3 mm,0
Field position	^FO50,40 (x,y in dots)	First two parameters of TEXT/BARCODE (x,y in dots)
Text	^A0N,40,40 ^FDHello^FS	TEXT 50,40,"0",0,12,12,"Hello"
Code 128	^BY2 ^BCN,80,Y,N,N ^FD12345^FS	BARCODE 50,150,"128",80,1,0,2,4,"12345"
QR code	^BQN,2,6 ^FDQA,data^FS	QRCODE 400,150,M,6,A,0,"data"
Data Matrix	^BXN,6,200 ^FDdata^FS	DMATRIX 400,150,120,120,"data"
Box / line	^GB300,2,2^FS	BOX x,y,xend,yend,2 / BAR x,y,w,h
Copies	^PQ10	PRINT 10,1
Darkness / speed	^MD15 ^PR4	DENSITY 10 SPEED 4

What actually changes

Units: ZPL works only in dots; TSPL accepts millimeters or inches in SIZE and GAP but positions in dots. A 203 dpi ZPL template moved to a 300 dpi TSC printer needs every coordinate scaled by 1.48.
Fonts: ZPL's ^A0 is a scalable font sized in dots; TSPL's internal fonts 1–8 are fixed bitmaps with integer multipliers, and font "0" is scalable but sized in dots per character. Text widths will not match exactly — check labels with long product names.
Barcode parameters: ZPL sets module width once with ^BY and reuses it; TSPL declares narrow and wide bar width in every BARCODE command. Human-readable text is a flag in both, but its font and position differ.
Label origin and orientation: both use the top-left corner, but TSPL's DIRECTION and REFERENCE commands change where (0,0) sits; set them explicitly in every job.
Graphics: ZPL ^GF hex bitmaps and TSPL BITMAP have different byte ordering and polarity; logos must be re-encoded, not copied.
RFID: ^RF commands have no equivalent on non-RFID TSC models; on RFID-capable TSC units the RFID command set is different and encoding must be redefined.

Before and after: the same label

^XA
^PW812 ^LL609
^FO40,30 ^A0N,36,36 ^FDSafety Harness^FS
^FO40,80 ^A0N,24,24 ^FDLOT: MX-24-0917^FS
^FO40,130 ^BY2 ^BCN,90,Y,N,N ^FD7501234567893^FS
^PQ1
^XZ

SIZE 101.6 mm,76.2 mm
GAP 3 mm,0
DIRECTION 1
CLS
TEXT 40,30,"0",0,11,11,"Safety Harness"
TEXT 40,80,"0",0,7,7,"LOT: MX-24-0917"
BARCODE 40,130,"128",90,1,0,2,4,"7501234567893"
PRINT 1,1

Note how the label size becomes physical units, every field carries its own coordinates, and the barcode declares its bar widths inline. The data — product, lot, GTIN — is untouched; only the wrapper changed.

Migration checklist

Confirm printer resolution (203 vs 300 dpi) before scaling coordinates.
Print every template once on the TSC unit and grade barcodes (ISO 15416); adjust narrow bar width if grades drop.
Verify long variable texts do not overflow — TSPL fonts are wider at equal nominal size.
Re-encode logos as TSPL bitmaps or, better, keep them as vector objects in the design tool.
Keep the ZPL version in your library: mixed fleets are the norm during a transition.

How EtikStudio does it

Paste or import the ZPL file; the interpreter renders it as an editable design in millimeters. Choose a TSC printer profile and export: EtikStudio regenerates TSPL with coordinates scaled to the target resolution, fonts substituted with matching metrics, barcodes rebuilt by module and logos re-encoded. The same design keeps printing on the Zebra units until the last one is retired.

Les exemples de commandes sont simplifiés pour la clarté ; la syntaxe exacte varie selon le modèle et le firmware. Testez toujours sur l'imprimante cible.