# Create Branded Labels

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.

## Requirements

* Your image must be uploaded in your account dashboard.
* Image file size limit is 512KB.
* PNG or JPG file type, with a white or other solid color background (no transparent backgrounds).
* You must use a carrier and service that supports label branding. If you are unsure if your carrier supports it, check the carrier guide.
* Branded labels are not supported for label requests that specify ZPL as the label format:
`"label_format": "zpl"`.
* Label images are not supported in the sandbox environment.


## Upload an Image

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.

To upload a logo, log into your dashboard and follow these steps.

1. Go to the ​Branding​ section and select ​Labels​​.


![Image List](/assets/image-list.5ac65be9a29ccce7fc2d1e2a02e51927a6a71af1176f788ce8c7c6e1af12fc27.d45bdd5f.png)

1. Click the **​Add Logo**​​ button.


![Add Image Button](/assets/add-image-button.7e5b560af0207764a6187f9078c9975fb6b5be439381bc17ab6185f2074a9639.d45bdd5f.png)

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


![Image Upload](/assets/image-upload.6ebfbbbec668110d9297e8226df11e38db35a6f30c98ba08146a91d9dab7528a.d45bdd5f.png)

1. Click **​Save Logo​​**.


Note the **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.

![Image List ID](/assets/image-list-id.07b14b477f8eb5596c788a5f025e59ae78af023456a08c218c638079a81e84f8.d45bdd5f.png)

## Example Label Request


```http
POST /v2/labels HTTP/1.1
Host: api.shipstation.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",
      "email": "recipient@example.com",
      "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",
      "email": "sender@example.com",
      "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.

![Custom Label Image](/assets/custom-label-image.215e1c6301d15d49dd13372ff1083cb66e6e7550daa05883ca3ea59ea2f25a77.d45bdd5f.png)

## Supported Carriers

The following popular services allow adding custom images to their labels:

| Carrier | Services Supported |
|  --- | --- |
| USPS from ShipStation and Stamps.com | 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 |