How does local ZPL parsing render vector PDF and PNG labels?
Every script pasted into ZPL II code (^XA … ^XZ) or loaded through the file drop zone renders instantly in this Zebra label viewer and ZPL to PDF converter. Clicking Download PDF runs @cantoo/pdf-lib inside a Web Worker to build vector rectangles, barcodes, QR modules, and text locally.
The Live label preview pane maps each printer dot to one unit of a W3C Scalable Vector Graphics 2 viewBox canvas. Clicking Download PNG (or Download PNGs (.zip) for batches) rasterizes labels onto an offscreen canvas at exact dot dimensions.
Converting 203 DPI dpmm dots for 4x6 shipping labels
Zebra scripts measure coordinates in dots, so Printer resolution (dpmm) sets physical scale. The engine computes native density as dpmm * 25.4 (152 DPI at 6 dpmm, 203 DPI at 8 dpmm, 300 DPI at 12 dpmm, 600 DPI at 24 dpmm) and converts dots into 72-pt/inch PDF units.
Pick a Label size preset (4 x 6 in down to 2.25 x 1.25 in) or type custom Width (in) (0.5–12) and Height (in) (0.5–18). Keeping Auto-size when ^PW / ^LL is set active honors embedded ^PW (40–8,000 dots) and ^LL (40–16,000 dots) bounds automatically.
Protecting customer PII and carrier postage compliance
Warehouse .zpl, .prn, .lbl, and .zip archives (up to 500 extracted files) hold recipient names, addresses, and tracking IDs. Local parsing keeps PII inside your tab, and when you lack raw ZPL scripts you can generate 4x6 address sheets from CSV recipient lists.
Using a ZPL to PDF converter locally is an operational convenience workflow for inspecting layouts and printing labels. Carrier-issued postage labels still require active carrier-generated barcodes, tracking numbers, and authorized carrier postage accounts before mailing, because local rendering does not verify carrier billing or manifesting.
Supported ZPL II commands, barcodes, and monochrome graphics
The parser separates multi-label ^XA...^XZ blocks, honors ^CC or ^CT prefix overrides, skips ^FX comments, and supports top-left ^FO or baseline ^FT coordinates. Label orientation commands ^PO (POI 180-degree invert) and ^LH/^LT offsets apply across all fields.
Text wrapping, ^FH UTF-8 escapes, and reverse print
Commands ^A and ^CF set font size, bold weight, and 90-degree orientation (N, R, I, B), while ^FB wraps blocks across L, C, or R alignment and \& breaks. Prefixing a field with ^FR renders white-on-black reverse overlays.
When shipping addresses include ^FH hex escapes (_C3_A9), the parser decodes bytes under the IETF RFC 3629 UTF-8 Standard for SVG and PNG output. PDF generation embeds WinAnsi Helvetica fonts, folding Latin-Extended letters (like ß to ss and € to EUR).
1D barcodes, QR codes, and ^GFA RLE bitmaps
Vector encoders draw 1D bars and 2D QR grids (ISO 18004 versions 1–40, levels L/M/Q/H) using ^BY module widths (1–20 dots). Monochrome ^GFA bitmaps unpack Zebra ASCII RLE (G–Y and g–z up to 4,096 rows) into pixel runs.
| Command group | Supported ZPL opcodes | Rendering behavior and limits |
|---|---|---|
| Label & canvas | ^XA, ^XZ, ^PW, ^LL, ^LH, ^LT, ^PO, ^PQ |
Bounds 40–8,000 wide by 40–16,000 tall; ^PQ capped at 200 copies |
| Text & encoding | ^FO, ^FT, ^A, ^CF, ^FB, ^FH, ^FR, ^FW |
L/C/R word wrap, UTF-8 hex escapes, 4 orientations (N/R/I/B) |
| 1D barcodes | ^BY, ^BC, ^B3, ^BE, ^B8, ^BU, ^B2 |
Code 128 (>;/>: stripped), Code 39, EAN-13/8, UPC-A, ITF-14 |
| 2D QR codes | ^BQ with QA, MA, LA, HA prefixes |
Native vector modules (1–16 magnification) via ISO 18004 encoder |
| Shapes & bitmaps | ^GB, ^GC, ^GD, ^GFA, ^GFB |
Rounded boxes, circles, diagonals, ASCII RLE (G–Y, g–z) & hex |
When creating standalone retail stickers without ZPL code, open our Code 128 and EAN-13 vector label generator for direct downloads. You can enter numeric or alphanumeric payloads and export crisp SVG or PDF graphics right away.
Thermal PDF vs 4-up US Letter and A4 sheet layouts
Thermal printers consume Exact label page (1 per page) PDFs matching exact label boxes (288 by 432 pt for 4 x 6 in). Office printers instead need multi-up imposition so four labels share one sheet.
Imposing 4-up and 2-up sheets with cut guides
Changing PDF page layout fits labels proportionally inside grid cells under the Library of Congress PDF 1.7 Standard 72 points-per-inch geometry. Pick US Letter 4-up sheet (2 × 2) (612 × 792 pt), A4 4-up sheet (2 × 2) (595.28 × 841.89 pt), or US Letter 2-up landscape (792 × 612 pt) with 18 pt margins and 8 pt gutters.
Checking Draw dashed cut guides adds 0.5 pt dashed borders ([4, 4]) around occupied slots. For store shelf tags without Zebra markup, use our layout tool to avoid manual margin math on shelf price tags.
Exporting high-density PNGs and batch ZIP limits
Multi-label inputs activate Prev and Next stepping inside Live label preview for pre-print QA. Enabling Repeat pages per ^PQ copy count honors ^PQ quantities up to a 200-page PDF cap to bound browser worker memory.
Clicking Download PNG saves zpl-label-1.png for single labels or zpl-labels-png.zip (up to 50 native-dot PNGs) for batches. Both PDF and PNG exports run offline once the ZPL to PDF converter loads.
Troubleshooting clipped barcodes, density mismatches, and scaling
When a 4 x 6 in label prints tiny in one corner or spills past the bottom, a mismatch between Printer resolution (dpmm) and the script’s native dot grid is usually responsible. Rendering an 8 dpmm (203 DPI, 812 × 1,218 dots) script at 12 dpmm (300 DPI) scales the label down to 67% width.
Check Auto-size when ^PW / ^LL is set if manual Width (in) or Height (in) inputs appear ignored, because embedded ^PW and ^LL values override preset dimensions unless unchecked. Also inspect preview warning banners whenever non-WinAnsi Unicode characters are folded in PDF text.
Print thermal PDFs at 100% (Actual Size) rather than Fit to Printable Area so driver scaling never distorts 1D bar widths. Per USPS Domestic Mail Manual 204 Barcodes, scannable mail barcodes require sharp edges, clear quiet zones, high print contrast, and zero skew.
Tip: Printing guest Wi-Fi instructions beside Zebra packing stations? Create scannable signs in the Wi-Fi QR card maker without sharing network passwords online.