{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/labels/formats","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/labels/formats","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/labels/formats","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Label Formats & Sizes","keywords":"shipping, labels, shipstation, documentation, api","siteUrl":"https://docs.shipstation.com","lang":"en-US","llmstxt":{"hide":false,"title":"ShipStation API LLM Docs","description":"Find links and references to all markdown documentation for use with LLMs","excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"label-formats--sizes","__idx":0},"children":["Label Formats & Sizes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ShipStation API supports labels in three formats: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pdf"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["png"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["zpl"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["By default, all ShipStation API labels are 4 inches x 6 inches (correlates to 100mm x 150mm for our metric users). You can optionally specify ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_layout: \"letter\""]}," to print 4x6 labels on US Letter size (8.5 inches x 11 inches) sheets when you create a label using the PDF or PNG formats. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["letter"]}," layout will accommodate two 4x6 labels on a single sheet."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Label format and size reference:"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Label Format"},"children":["Label Format"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Default Size"},"children":["Default Size"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pdf"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["4\" x 6\""]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Adobe PDF format. Also supports printing the 4\" x 6\" label to an 8.5\" x 11\" (US Letter) sheet."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["png"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["4\" x 6\""]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A PNG (portable network graphics) image file. Also supports printing the 4\" x 6\" label to an 8.5\" x 11\" (US Letter) sheet."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["zpl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["4\" x 6\""]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://en.wikipedia.org/wiki/Zebra_Programming_Language"},"children":["Zebra Programming Language"]}," (ZPL) format, which is useful for printing with a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.zebra.com/us/en/products/printers.html"},"children":["Zebra Printer"]},". ZPL does ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," support printing to 8.5\" x 11\" sheets."]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NOTE:"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"about-supported-label-sizes","__idx":1},"children":["About Supported Label Sizes"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The 8.5\" x 11\" option prints two 4\" x 6\" labels per page when you are printing multiple labels at the same time."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["ShipStation API does not print standard-sized stamps or 2\" x 3\" address labels."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"label-download-options","__idx":2},"children":["Label Download Options"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you purchase a label, the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/labels/create-a-label"},"children":["create label response"]}," will return label URLs in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_download"]}," object so you can download the labels in each of the available formats, unless you specify which label format you want in the request body (which you can do when choosing the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["inline"]}," ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/labels/downloading"},"children":["label download type"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The inline label download type will instead provide a single Base64 encoded label of the format specified in your request body. See our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/labels/downloading"},"children":["Downloading a Label page"]}," to learn more about label download options."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-label-request--response","__idx":3},"children":["Example Label Request & Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following example demonstrates setting the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_layout"]}," property to indicate a 4x6 label should be returned in the response."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v1/labels HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\nContent-Length: 1054\n\n{\n  \"label_layout\": \"4x6\",\n  \"shipment\": {\n    \"service_code\": \"usps_priority_mail\",\n    \"ship_to\": {\n      \"name\": \"Amanda Miller\",\n      \"phone\": \"555-555-5555\",\n      \"email\": \"recipient@example.com\",\n      \"address_line1\": \"525 S Winchester Blvd\",\n      \"city_locality\": \"San Jose\",\n      \"state_province\": \"CA\",\n      \"postal_code\": \"95128\",\n      \"country_code\": \"US\",\n      \"address_residential_indicator\": \"yes\"\n    },\n    \"ship_from\": {\n      \"company_name\": \"Example Corp.\",\n      \"name\": \"John Doe\",\n      \"phone\": \"111-111-1111\",\n      \"email\": \"sender@example.com\",\n      \"address_line1\": \"4009 Marathon Blvd\",\n      \"address_line2\": \"Suite 300\",\n      \"city_locality\": \"Austin\",\n      \"state_province\": \"TX\",\n      \"postal_code\": \"78756\",\n      \"country_code\": \"US\",\n      \"address_residential_indicator\": \"no\"\n    },\n    \"confirmation\": \"none\",\n    \"insurance_provider\": \"none\",\n    \"packages\": [\n      {\n        \"weight\": {\n          \"value\": 1.0,\n          \"unit\": \"ounce\"\n        }\n      }\n    ]\n  }\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Notice that the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_download"]}," object in the response includes links to download the label as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pdf"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["png"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["zpl"]},". There is also an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["href"]}," field, which exists for backward compatibility purposes. We recommend that you use the other fields instead."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"label_id\": \"se-test-41817394\",\n  \"status\": \"processing\",\n  \"shipment_id\": \"se-41817394\",\n  \"ship_date\": \"2017-04-03T00:00:00Z\",\n  \"created_at\": \"2017-04-03T17:30:19.9541821Z\",\n  \"shipment_cost\": {\n    \"currency\": \"usd\",\n    \"amount\": 0.0\n  },\n  \"insurance_cost\": {\n    \"currency\": \"usd\",\n    \"amount\": 0.0\n  },\n  \"tracking_number\": \"9999999999999\",\n  \"is_return_label\": false,\n  \"is_international\": false,\n  \"batch_id\": \"\",\n  \"carrier_id\": \"se-0\",\n  \"service_code\": \"usps_priority_mail\",\n  \"package_code\": \"package\",\n  \"voided\": false,\n  \"voided_at\": null,\n  \"label_format\": \"pdf\",\n  \"label_layout\": \"4x6\",\n  \"trackable\": true,\n  \"carrier_code\": \"stamps_com\",\n  \"tracking_status\": \"unknown\",\n  \"label_download\": {\n    \"pdf\": \"https://api.shipengine.com/v1/downloads/1/s_Tqsu9euEKub6Acc_9UIg/testlabel-2128732.pdf\",\n    \"png\": \"https://api.shipengine.com/v1/downloads/1/s_Tqsu9euEKub6Acc_9UIg/testlabel-2128732.png\",\n    \"zpl\": \"https://api.shipengine.com/v1/downloads/1/s_Tqsu9euEKub6Acc_9UIg/testlabel-2128732.zpl\",\n    \"href\": \"https://api.shipengine.com/v1/downloads/1/s_Tqsu9euEKub6Acc_9UIg/testlabel-2128732.pdf\"\n  },\n  \"form_download\": null,\n  \"insurance_claim\": {\n    \"href\": \"https://www.dsiins.com/extclaims/Default.asp?cid=shipengine&psid=0&shipmentid=0\"\n  }\n}\n","lang":"json"},"children":[]}]},"headings":[{"value":"Label Formats & Sizes","id":"label-formats--sizes","depth":1},{"value":"About Supported Label Sizes","id":"about-supported-label-sizes","depth":3},{"value":"Label Download Options","id":"label-download-options","depth":2},{"value":"Example Label Request & Response","id":"example-label-request--response","depth":3}],"frontmatter":{"seo":{"title":"Label Formats & Sizes"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/labels/formats","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}