Sign In
Products
ZPL ViewerBarcode GeneratorImage → ZPLZPL cheat sheetLabel DesignerTemplate Gallery
Developers
API QuickstartAPI ReferenceMCP ServerBulk GenerationWebhooksSDKs & ExamplesLimitsDirectPrint agent NewGitHub ActionVS Code extensionOn-Premise
Solutions
Logistics & ShippingE-CommerceERP & WMSManufacturingRetailHealthcare & LaboratoryAll solutions
Tools
ZPL Diagnostics HubZPL DebuggerSize & DPI AnalyzerDPI ConverterBarcode fit calculatorShipping Label AnalyzerFont InspectorOrientation DebuggerCalibration AssistantPrinter Compatibility CheckerBarcode Readability CheckerPrinter Language DetectorThermal Printer Test PackZPL ToolsEPL ToolsTSPL ToolsCPCL ToolsPrinter Language ConverterAll ToolsGuidesPricing
Language
EnglishTürkçeDeutsch
Home›All CPCL commands›BOX

BOX — Box

Draws a 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

! 0 200 200 210 1
PAGE-WIDTH 576
BOX 10 10 560 200 2
PRINT

Open this example in the preview →

Open the validator →

Rendered example

BOX 10 10 560 200 2

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

Parameters

ParameterMeaning
x1 y1Top-left corner, in dots; fields are space-separated, no commas
x2 y2Bottom-right corner, in dots — not width/height
tLine thickness in dots

Common mistake

Separating arguments with commas: CPCL fields are space-separated, so BOX 10,10,560,200,2 becomes one broken argument and nothing is drawn. Also x2/y2 is a corner, not a width.

The same job in other languages

ZPL equivalent: ^GB · Language comparison

All CPCL commands

! · PAGE-WIDTH · TEXT · TEXT90 · TEXT180 · TEXT270 · BARCODE · LINE · EXPANDED-GRAPHICS · PRINT · FORM · CONTRAST · TONE · SPEED · JOURNAL · SETMAG · CENTER

All CPCL commands