# How to convert ZPL to PDF

By Rotomal team · Updated 2026-11-07 · Part of [Label Render](https://rotomal.com/zpl-to-pdf/)

**Short answer:** To convert ZPL to PDF, render the ZPL at the printer resolution and label size it was written for, then save the result as a PDF. For a single label, paste it into an online ZPL viewer and download the PDF. For batches, send the file to a rendering API with the header Accept: application/pdf. For private or offline work, run an open-source converter such as ZPL2PDF. If your carrier or shipping platform can produce PDF labels directly, switching that setting is the simplest fix.

## Before you start: know the resolution and label size

ZPL positions everything in printer dots, so the same file looks different at different resolutions. Most shipping labels are written for 203 dpi printers (8 dots per mm) on 4x6 inch stock; some are written for 300 dpi (12 dots per mm). If the PDF looks too small or too large, the resolution is usually wrong, not the file.

| Dots per mm | Dots per inch | Typical use |
| --- | --- | --- |
| 6 dpmm | 152 dpi | Older or low-cost printers |
| 8 dpmm | 203 dpi | Most desktop shipping label printers |
| 12 dpmm | 300 dpi | Industrial printers, small barcodes |
| 24 dpmm | 600 dpi | Very small labels and fine print |

## Option 1: an online ZPL viewer (one label)

- Open a ZPL viewer such as Labelary's online viewer.
- Paste the ZPL, which starts with ^XA and ends with ^XZ.
- Set the print density (for example 8 dpmm) and label size (for example 4 x 6 inches).
- Check the preview, then download it as PDF.
- Remember that a shipping label contains a name and address; check the service's data policy before pasting real labels.

## Option 2: a rendering API (batches)

Labelary runs a rendering API at labelary.com that returns PDFs at densities of 6, 8, 12 and 24 dpmm, and can put every label in a file into one PDF (PDF output only). The free tier allows 3 requests per second, 5,000 requests per day and 50 labels per request.

## Option 3: an offline open-source converter

ZPL2PDF is an MIT-licensed converter for Windows, Linux and macOS with a command-line mode, a folder-watching mode that converts files as they arrive, and a TCP virtual-printer mode. Its default renderer works offline, so labels never leave your machine. You install and update it yourself.

## Option 4: ask your system for PDF in the first place

Many shipping platforms can output labels as PDF instead of ZPL. Linnworks, for example, says ZPL and EPL formats cannot be printed to PDF from its Open Orders screen and tells users to change the label format to PDF or RAW in the printer configuration. If you control the setting, this avoids conversion entirely.

## Common problems and fixes

- Label prints tiny or huge: the density is wrong; try 8 dpmm, then 12 dpmm.
- Blank area where a logo should be: the label recalls a graphic stored in the printer. Convert the file that downloads the graphic first, in the same session or batch.
- Barcode will not scan after printing: the PDF was scaled. Print at 100% or Actual size, with Fit to page turned off.
- Only the first label converts: the file holds several ^XA…^XZ blocks; use a tool that outputs all labels, or omit the index in the API call.

## If you want this done for you

Label Render converts ZPL II in batches by upload, email, watch folder or API, at the original resolution, with a report of anything it could not render, and deletes your files after conversion. Plans start at $5 a month. For EPL2 files, see https://rotomal.com/epl-to-pdf/how-to-convert-epl-to-pdf/

## FAQ

### Is there a free way to convert ZPL to PDF?

Yes. Online viewers and Labelary's free API cover small volumes, and open-source tools such as ZPL2PDF are free to run yourself.

### Does Zebra offer a ZPL to PDF converter?

Not according to a reply on Zebra's own developer forum, which points to third-party services instead.

### How do I convert many ZPL labels into one PDF?

Put them in one file and use a converter that outputs all labels; with Labelary's API, leave the label index out of the URL and request PDF.

## Sources

- Labelary: Label API documentation, limits and plans https://labelary.com/service.html
- Zebra developer forum: ZPL to PDF https://developer.zebra.com/content/zpl-pdf
- ZPL2PDF on GitHub https://github.com/brunoleocam/ZPL2PDF
- Linnworks: ZPL/EPL label formats cannot be printed to PDF https://help.linnworks.com/support/solutions/articles/7000070493-shipping-general-zpl-epl-label-formats-cannot-be-printed-to-pdf

[Label Render](https://rotomal.com/zpl-to-pdf/) does this for you. Request it free, no card: https://rotomal.com/zpl-to-pdf/request/
---
Rotomal · https://rotomal.com/zpl-to-pdf/how-to-convert-zpl-to-pdf/ · hello@rotomal.com