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.
  1. Navigate to the ShipEngine dashboard Branding Settings section and click the Labels tab.

Image List

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

Add Image Button

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

Image Upload

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

Add Image

  1. 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"
        }
      }
    ]
  }
}'
  • curl
  1. You should see your image on the generated label.

Image Upload