shipengine-logo

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:

CarrierServices Supported
Stamps.comUSPS First Class Mail
USPS Media Mail
USPS Parcel Select Ground
USPS Priority Mail
USPS Priority Mail Express
EndiciaUSPS First Class Mail
USPS Media Mail
USPS Parcel Select Ground
USPS Priority Mail
USPS Priority Mail Express
UPSExpedited 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
FedexFedEx 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 ExpressExpress Envelope
DHL eCommerceAll Services
NewgisticsAll Services

Uploading Label Images

  1. Go to the ​Branding​ section and select ​Labels​​.
Image List
  1. Click the ​Add Logo​​ button.
Add Image Button
  1. 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.
Image Upload
  1. Click the ​Save Logo​​ button.
Add Image
  1. 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.
Image List ID

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"
        }
      }
    ]
  }
}
  1. You should see your image on the generated label.
Custom Label Image