Skip to content

Use this guide to learn how to use the Shippo API to create different label sizes for your application.

Setting your label format

Specify your preferred label format by setting the label_file_type parameter to one of the label tokens when calling the transaction endpoint to purchase your label.

Each carrier supports different label size options. Refer to our carrier capabilities for carrier specific details.

If you don't set the label_file_type, the Shippo API will use the default format set in the Shippo dashboard.

curl --location --request POST 'https://api.goshippo.com/transactions' \
--header 'Authorization: ShippoToken <API_TOKEN>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "rate": "a5c9d1bec93149f5bedc3a9374b50970",
  "async": false,
  "label_file_type": "PDF"
}'

Shipping label format sizes

Label typeDimensions (imperial)Dimensions (metric)Token
2.3 x 7.5 inch PDF2.3 x 7.5 inch59 x 191 mmPDF_2.3x7.5
2.3 x 7.5 inch PNG2.3 x 7.5 inch59 x 191 mmPNG_2.3x7.5
4 x 8 inch PDF4 x 8 inch100 x 200 mmPDF_4x8
4×6 inch PDF4 x 6 inch102 x 153 mmPDF_4x6
8.5×11 inch PDF8.5 x 11 inch210 x 279 mmPDF
A4 PDF8.3 x 11.7 inch210 x 297 mmPDF_A4
A5 PDF5.8 x 8.3 inch148 x 210 mmPDF_A5
A6 PDF4.1 x 5.8 inch105 x 148 mmPDF_A6
ZPL IIZPLII
PNGPNG