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 walk-through.

If you're looking for a way to customize the return address that prints on a label, we outline that process here.

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

Go to the Branding section and select Labels.

Click the Add Logo button.

Enter a title in the Logo Name field, then click Upload Image to select your image from your file explorer. A preview of your logo will appear on the example label.

Click the Save Logo button.

Note the Image ID 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.

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
POST /v1/labels HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "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.

Documentation

API Status