{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/labels/branding","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/labels/branding","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/labels/branding","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Create Branded Labels","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":"create-branded-labels","__idx":0},"children":["Create Branded Labels"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can add a touch of your brand on your shipping labels to delight your customers when they receive your package. This guide provides details and instructions about adding your brand’s logo or any other image to your labels."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you're looking for a way to customize the return address that prints on a label, you can learn about that in our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/ship-from-a-warehouse#overriding-the-return-address"},"children":["Shipping from a Warehouse page"]}," under the section \"Overriding the Return Address\"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirements","__idx":1},"children":["Requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your image must be uploaded in your account dashboard."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Image file size limit is 512KB."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["PNG or JPG file type, with a white or other solid color background (no transparent backgrounds)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You must use a carrier and service that supports label branding. If you are unsure if your carrier supports it, check the carrier guide."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Branded labels are not supported for label requests that specify ZPL as the label format:"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"label_format\": \"zpl\""]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Label images are not supported in the sandbox environment."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"upload-an-image","__idx":2},"children":["Upload an Image"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the best label image results, we recommend a square (or nearly square) logo that can be sized to 1\" x 1\" on the label."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To upload a logo, log into your dashboard and follow these steps."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to the ​Branding​ section and select ​Labels​​."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-list.5ac65be9a29ccce7fc2d1e2a02e51927a6a71af1176f788ce8c7c6e1af12fc27.f22761a0.png","alt":"Image List"},"children":[]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["​Add Logo"]},"​​ button."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/add-image-button.7e5b560af0207764a6187f9078c9975fb6b5be439381bc17ab6185f2074a9639.f22761a0.png","alt":"Add Image Button"},"children":[]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":3},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter a title in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["​Logo Name"]},"​ field, then click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["​Upload Image"]},"​​ to select your image. A preview of your logo will appear on the example label."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-upload.6ebfbbbec668110d9297e8226df11e38db35a6f30c98ba08146a91d9dab7528a.f22761a0.png","alt":"Image Upload"},"children":[]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":4},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["​Save Logo​​"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Note the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Image ID"]}," in the Labels section. You can use the ID in label requests to ShipStation API to add your custom image to the generated label."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-list-id.07b14b477f8eb5596c788a5f025e59ae78af023456a08c218c638079a81e84f8.f22761a0.png","alt":"Image List ID"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-label-request","__idx":3},"children":["Example Label Request"]},{"$$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\n\n{\n  \"label_image_id\": \"img_DtBXupDBxREpHnwEXhTfgK\",\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      \"name\": \"John Doe\",\n      \"phone\": \"111-111-1111\",\n      \"email\": \"sender@example.com\"\n      \"company_name\": \"Example Corp.\",\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    \"packages\": [\n      {\n        \"weight\": {\n          \"value\": 20,\n          \"unit\": \"ounce\"\n        }\n      }\n    ]\n  }\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You should see your image on the generated label."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/custom-label-image.215e1c6301d15d49dd13372ff1083cb66e6e7550daa05883ca3ea59ea2f25a77.f22761a0.png","alt":"Custom Label Image"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"supported-carriers","__idx":4},"children":["Supported Carriers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following popular services allow adding custom images to their labels:"]},{"$$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":"Carrier"},"children":["Carrier"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Services Supported"},"children":["Services Supported"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USPS from ShipStation and Stamps.com"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USPS First Class Mail ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," USPS Media Mail ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," USPS Parcel Select Ground ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," USPS Priority Mail ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," USPS Priority Mail Express"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["UPS"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Expedited Mail Innovations ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," Mail Innovations - First Class ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," Mail Innovations - Priority Mail ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," UPS 2nd Day Air AM® ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," UPS 2nd Day Air® ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," UPS 3 Day Select® ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," UPS Ground® ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," UPS Next Day Air Saver® ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," UPS Next Day Air® ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," UPS Next Day Air® Earl"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fedex"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["FedEx 1Day® Freight ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," FedEx 2Day® ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," FedEx 2Day® A.M. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," FedEx 2Day® Freight ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," FedEx 3Day® Freight ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," FedEx Express Saver® ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," FedEx First Overnight® ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," FedEx First Overnight® Freight ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," FedEx Ground® ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," FedEx Home Delivery® ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," FedEx International Ground® ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," FedEx Priority Overnight® ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," FedEx Standard Overnight®"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["DHL Express"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Express Envelope"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["DHL eCommerce"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["All Services"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Newgistics"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["All Services"]}]}]}]}]}]},"headings":[{"value":"Create Branded Labels","id":"create-branded-labels","depth":1},{"value":"Requirements","id":"requirements","depth":2},{"value":"Upload an Image","id":"upload-an-image","depth":2},{"value":"Example Label Request","id":"example-label-request","depth":2},{"value":"Supported Carriers","id":"supported-carriers","depth":2}],"frontmatter":{"seo":{"title":"Create Branded Labels"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/labels/branding","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}