Skip to content

ZPL viewer and ZPL to PDF converter

Render ZPL scripts with Code 128 barcodes, QR codes, boxes, and graphics locally to PDF or PNG.

Live label preview

Paste ZPL commands on the left or click Load sample ZPL to render an instant label preview locally.

How to use ZPL to PDF

  1. Parse Zebra ZPL II commands. Paste markup into ZPL II code (^XA ... ^XZ), drop .zpl, .prn, .txt, .lbl, or .zip archives, or click Load sample ZPL.
  2. Match hardware resolution and physical size. Pick Printer resolution (dpmm), choose a Label size preset or custom Width (in) and Height (in), and toggle Auto-size when ^PW / ^LL is set.
  3. Configure PDF layout and batch copies. Select Exact label page (1 per page), US Letter 4-up, A4 4-up, or US Letter 2-up, enable Draw dashed cut guides on sheets, or check Repeat pages per ^PQ copy count.
  4. Verify preview and export files. Step across multi-label batches with Prev and Next, then click Download PDF for vector output or Download PNG for dot-exact raster images.

Everything you type stays in this browser on your device. Nothing is uploaded, and your saved details are never sent anywhere.

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.

Questions

Why convert ZPL scripts locally instead of using an online cloud viewer?

Shipping labels contain customer names, street addresses, phone numbers, and order tracking codes. Parsing ZPL II commands inside your browser tab keeps recipient PII off remote servers and avoids external API rate limits.

Which printer dpmm setting matches 203 DPI and 300 DPI Zebra hardware?

Choose 8 dpmm for standard 203 DPI shipping printers and 12 dpmm for 300 DPI warehouse printers. Micro-label printers use 24 dpmm (600 DPI), while older legacy units correspond to 6 dpmm (152 DPI).

How do I print 4x6 ZPL labels on standard US Letter or A4 sheets?

Switch PDF page layout from Exact label page (1 per page) to US Letter 4-up sheet (2 x 2), A4 4-up sheet (2 x 2), or US Letter 2-up landscape. Enable Draw dashed cut guides for clean trimming on office laser or inkjet printers.

Which 1D barcodes and 2D QR codes does the ZPL parser support?

The parser encodes 1D symbologies including Code 128 (^BC), Code 39 (^B3), EAN-13 (^BE), EAN-8 (^B8), UPC-A (^BU), and ITF-14 (^B2) with bearer bars. It also draws ISO 18004 QR codes (^BQ) across error-correction levels L, M, Q, and H.

Why is my batch ZPL PDF or PNG export capped at 200 or 50 labels?

Both Download PDF and Repeat pages per ^PQ copy count cap output at 200 labels so vector PDF generation stays responsive inside browser worker memory. Batch PNG ZIP exports cap at 50 rasterized labels per download.

Are non-Latin characters supported inside ZPL PDF text fields?

Yes in SVG previews and PNG exports, where ^FH UTF-8 hex escapes render using full browser Unicode fonts. PDF exports embed standard WinAnsi Helvetica fonts, folding Latin-Extended characters and flagging unsupported glyphs.

Updated