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.
- 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.
- 2Set the label size to 4" x 6". ZPL labels are 4x6 only: ZPL does not print to 8.5" x 11" sheets.
- 3API: in the create-label request, set "label_format": "zpl" and "label_layout": "4x6". Without label_format the API returns PDF.
- 4Read the download link from label_download.zpl in the response. It points at a .zpl file and stays valid for 90 days.
- 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.