BOX — Box outline

Draws an empty rectangle from two corners and a line thickness.

Engine status: Rendered

This command produces visible output in the preview.

Syntax

BOX x1, y1, x2, y2, t

Example

SIZE 100 mm, 150 mm
GAP 3 mm, 0 mm
CLS
BOX 40, 40, 760, 400, 4
PRINT 1

Open this example in the preview →

Open the validator →

Rendered example

Output of the example above in our renderer (203 dpi). Not verified on a physical printer.

Parameters

Parameter	Meaning
`x1, y1`	Top-left corner, in dots
`x2, y2`	Bottom-right corner, in dots — not width/height
`t`	Line thickness in dots; the inside stays empty

Common mistake

Reading the second pair as width/height: BOX 40, 40, 200, 100, 4 draws a 160×60 box with corners (40,40)–(200,100), not a 200×100 one. ZPL ^GB takes width/height; compute the corners when porting.

The same job in other languages

ZPL equivalent: ^GB · EPL X · Language comparison

All TSPL commands

SIZE · GAP · REFERENCE · CLS · TEXT · BARCODE · QRCODE · BAR · BITMAP · PRINT · DIRECTION · DENSITY · SPEED · OFFSET · SET · CODEPAGE · BLINE

All TSPL commands