Create Custom Shipping Labels

You can add a touch of your brand on your shipping labels to delight your customers when they receive your package. Learn how ShipEngine can help you easily add your brand’s logo or any other image to your labels in this walkthrough.

Supported Carriers

We currently support adding label images for the following carriers:

Carrier	Services Supported
Stamps.com	USPS First Class Mail USPS Media Mail USPS Parcel Select Ground USPS Priority Mail USPS Priority Mail Express
Endicia	USPS First Class Mail USPS Media Mail USPS Parcel Select Ground USPS Priority Mail USPS Priority Mail Express
UPS	Expedited Mail Innovations Mail Innovations - First Class Mail Innovations - Priority Mail UPS 2nd Day Air AM® UPS 2nd Day Air® UPS 3 Day Select® UPS Ground® UPS Next Day Air Saver® UPS Next Day Air® UPS Next Day Air® Earl
Fedex	FedEx 1Day® Freight FedEx 2Day® FedEx 2Day® A.M. FedEx 2Day® Freight FedEx 3Day® Freight FedEx Express Saver® FedEx First Overnight® FedEx First Overnight® Freight FedEx Ground® FedEx Home Delivery® FedEx International Ground® FedEx Priority Overnight® FedEx Standard Overnight®
DHL Express	Express Envelope
DHL eCommerce	All Services
Newgistics	All Services

Uploading label images

tips

For best label image results

The squarer your image the better.

Image size limit is 512KB.

Navigate to the ShipEngine dashboard Branding Settings section and click the Labels tab.

Image List

Click on the + Add an image button to open the image upload screen.

Enter an image name in the text box and then drag an image or click to upload.

Image Upload

Click the Create Image button to save and go back to your list of images.

Add Image

Note the image entry in the Labels section. You can use the ID in label requests to the ShipEngine API to add your custom image to the generated label.

Image List ID

Example

  curl -iX POST https://api.shipengine.com/v1/labels \
-H 'Content-Type: application/json' \
-H 'API-Key: __YOUR_API_KEY_HERE__' \
-d '
{
  "label_image_id": "img_DtBXupDBxREpHnwEXhTfgK",
  "shipment": {
    "service_code": "usps_priority_mail",
    "ship_to": {
      "name": "Amanda Miller",
      "phone": "555-555-5555",
      "address_line1": "525 S Winchester Blvd",
      "city_locality": "San Jose",
      "state_province": "CA",
      "postal_code": "95128",
      "country_code": "US",
      "address_residential_indicator": "yes"
    },
    "ship_from": {
      "name": "John Doe",
      "phone": "111-111-1111",
      "company_name": "Example Corp.",
      "address_line1": "4009 Marathon Blvd",
      "address_line2": "Suite 300",
      "city_locality": "Austin",
      "state_province": "TX",
      "postal_code": "78756",
      "country_code": "US",
      "address_residential_indicator": "no"
    },
    "packages": [
      {
        "weight": {
          "value": 20,
          "unit": "ounce"
        }
      }
    ]
  }
}'

You should see your image on the generated label.

Image Upload