Launch

30% off your first month of Pro30% off month one$9.90 → $6.93

See plans
ZPL em PDF

Guide · ShipStation

ShipStation ZPL labels

ShipStation produces PDF labels by default. ZPL is available in the web app and through the API, and it prints sharper on a Zebra than a PDF does, but it is not a per-order choice. This page covers both ways to get ZPL, what the file contains, and how to look at one when there is no Zebra on your desk.

Checked on November 16, 2026

How to get ZPL out of ShipStation

There are two routes, and they answer to different people. The web app needs ShipStation's support team. The API needs one field in the label request.

  1. 1Web app: contact ShipStation support and ask for ZPL labels. They configure the account. There is no toggle to flip yourself, and the change applies to the account rather than to one store.
  2. 2Set the label size to 4" x 6". ZPL labels are 4x6 only: ZPL does not print to 8.5" x 11" sheets.
  3. 3API: in the create-label request, set "label_format": "zpl" and "label_layout": "4x6". Without label_format the API returns PDF.
  4. 4Read the download link from label_download.zpl in the response. It points at a .zpl file and stays valid for 90 days.
  5. 5Or set "label_download_type": "inline" and the label comes back inside the response instead, as a base64 data URI with the media type application/zpl.

What you end up with

A .zpl file: plain text holding one ^XA…^XZ block per label, at 4x6. Inline, it is the same text base64-encoded, and it has to be decoded before a printer or a viewer will read it.

Limits worth knowing before you switch

ShipStation's own help pages describe ZPL as needing some configuration and coming with limitations, and the hard ones are in the API documentation. Size is fixed at 4x6. Rotation is 0 or 180 degrees only, where the other formats accept 90 and 270 as well.

Density is the one the file does not tell you. A ZPL label is drawn in printer dots rather than inches, so it comes out at the intended size only on a printer of the density it was made for. ShipStation's help notes that some Zebras, the LP 2844 among them, need the 203 DPI setting. The 203 vs 300 dpi page explains why a mismatch prints the label at two thirds of its size.

Viewing a ShipStation .zpl without a printer

A .zpl opened in a text editor shows commands, not a label. To check what ShipStation actually produced, which is the first thing to do when a carrier rejects a label, drop the file into the converter on this page. It draws every label in the file, lets you page through them, and exports a PDF or PNG.

If you used the inline option, decode the base64 first and save the result as a .zpl, or paste the decoded text straight into the converter.

Printing it

On a Zebra, send the .zpl raw: a Generic / Text Only queue, copy /b to a shared printer, or TCP port 9100. Printing it through a normal driver prints the code as text. The page on Zebras printing code covers that symptom.

Without a Zebra, convert it to a PDF here and print at 100% scale on 4x6 stock. A PDF printed with fit to page rescales the barcode, which is enough to stop a scanner reading it.

Drop a ShipStation .zpl to see every label in it

Drag the file in, paste the code, or pick it from your device

.txt · .zpl · .prn · .zip · .pdf · .png · .jpg — 5 labels a day

The conversion happens in your browser: your file never leaves your device.How that works
Free, no signupNo uploadNo watermarkBatches of many filesPDF · PNG · ZIP

Questions

Frequently asked questions

How do I get ZPL labels from ShipStation?

In the web app, ask ShipStation support. They enable ZPL for the account, and labels are then 4x6. Through the API, set label_format to zpl and label_layout to 4x6 in the create-label request, and download the file from label_download.zpl.

Can ShipStation ZPL labels print on letter paper?

No. ShipStation's documentation says ZPL does not support 8.5" x 11" sheets. ZPL labels are 4x6 only. For letter paper, request PDF or PNG instead.

How do I open a .zpl file from ShipStation?

A text editor only shows the commands. Drop the file into the converter on this page to see each label rendered, then download a PDF or PNG if you need one. Nothing is uploaded, because the conversion runs in your browser.

Why does my ShipStation ZPL label print too small?

ZPL is measured in printer dots, so a label made for a 203 dpi printer prints at about two thirds of its size on a 300 dpi one. Match the label's density to the printer. ShipStation notes that some Zebras need 203 DPI.

Other guides