---
title: "Upload site seal logo"
source_url: https://dev.digicert.com/certcentral-apis/services-api/orders/upload-site-seal-logo.html
api_method: POST
api_endpoint: "/services/v2/order/certificate/123456789/site-seal/logo"
api_url: "https://www.digicert.com/services/v2/order/certificate/123456789/site-seal/logo"
---

**POST** `https://www.digicert.com/services/v2/order/certificate/123456789/site-seal/logo`

Use this endpoint to upload your company logo to display in the site seal on your website.


> **Info**
>
> Secure Site and Secure Site Pro SSL/TLS certificates support the option to display a DigiCert Smart Seal on your website. With the Smart Seal, you can add your company logo to the site seal that displays on your website.


## Request format

To submit a request to the **Upload site seal logo** endpoint:

- Set the `Content-Type` header to `image/svg+xml`.
- Submit the raw XML data for the SVG image as the payload of the request.

## Logo approval

After uploading your company logo, DigiCert must approve it before it appears in the site seal on your website.

- Approval times may vary. Your logo appears in the site seal within two hours of being approved.
- DigiCert only stores one approved logo for your site seal.
- DigiCert deletes unapproved logos.

## Display logo

Uploading the logo only submits the logo for approval. For the logo to appear in the site seal, you must also:

- Turn on the option to display the logo.
  With the Services API, use the [Update site seal settings](https://dev.digicert.com/md/certcentral-apis/services-api/orders/update-site-seal-settings.md) endpoint to set the `seal_use_logo` parameter to a value of `true`.
- Turn on the Smart Seal hover feature.
  With the Services API, use the [Update site seal settings](https://dev.digicert.com/md/certcentral-apis/services-api/orders/update-site-seal-settings.md) endpoint to set the `seal_hover` parameter to a value of `true`.

## Logo format

Before uploading your logo, make sure it meets these requirements:

- File format must be SVG Tiny Portable/Secure file. <a href="https://www.digicert.com/blog/getting-ready-for-bimi-prep-your-logo" target="_blank" rel="noopener noreferrer">Learn how to render this file type</a>.
- The image should have a square aspect ratio (1:1).
- Center the image. Centered images display optimally in a circle.
- Use non-transparent backgrounds.

## Replace logo

Uploading a logo replaces any existing logo for the site seal.

- We delete the existing logo from your account and remove it from the site seal on your website.
- After we approve the new logo, it will appear in the site seal on your website.

Approval times may vary. Your new logo will replace the old logo within two hours of being approved.

## Related topics

- [Site seal settings](https://dev.digicert.com/md/certcentral-apis/services-api/orders/site-seal-settings.md)
- [Update site seal settings](https://dev.digicert.com/md/certcentral-apis/services-api/orders/update-site-seal-settings.md)
- [Email site seal](https://dev.digicert.com/md/certcentral-apis/services-api/orders/email-site-seal.md)
- <a href="https://docs.digicert.com/en/certcentral/manage-certificates/digicert-site-seals/install-your-digicert-site-seal.html" target="_blank" rel="noopener noreferrer">Site seal installation instructions</a>

## Example requests and responses


> **Info**
>
> In the examples below, replace `{{svg_xml}}` with the XML data for your own SVG image.


**cURL**

```bash
curl --request POST 'https://www.digicert.com/services/v2/order/certificate/123456789/site-seal/logo' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: image/svg+xml' \
--data-raw {{svg_xml}}
```

**Python**

```python
import requests

url = "https://www.digicert.com/services/v2/order/certificate/123456789/site-seal/logo"

payload={{svg_xml}}
headers = {
  'X-DC-DEVKEY': {{api_key}},
  'Content-Type': 'image/svg+xml'
  }

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)
```

**Go**

```go
package main

import (
		"fmt"
		"strings"
		"net/http"
		"io/ioutil"
)

func main() {

		url := "https://www.digicert.com/services/v2/order/certificate/123456789/site-seal/logo"
		method := "POST"

		payload := strings.NewReader({{svg_xml}})

		client := &http.Client {
		}
		req, err := http.NewRequest(method, url, payload)

		if err != nil {
				fmt.Println(err)
				return
		}
		req.Header.Add("X-DC-DEVKEY", {{api_key}})
		req.Header.Add("Content-Type", "image/svg+xml")

		res, err := client.Do(req)
		if err != nil {
				fmt.Println(err)
				return
		}
		defer res.Body.Close()

		body, err := ioutil.ReadAll(res.Body)
		if err != nil {
				fmt.Println(err)
				return
		}
		fmt.Println(string(body))
}
```

**NodeJS**

```javascript
var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://www.digicert.com/services/v2/order/certificate/123456789/site-seal/logo',
  'headers': {
    'X-DC-DEVKEY': {{api_key}},
    'Content-Type': 'image/svg+xml'
  },
  body: {{svg_xml}}

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});
```


**204 No Content**

```json
// No content
```

**400 Bad Request (MIME type mismatch)**

```json
{
  "errors": [
    {
      "code": "mime_type_mismatch",
      "message": "The Content-Type header does not match the MIME type of the POSTed file."
    }
  ]
}
```

**400 Bad Request (Invalid product)**

```json
{
  "errors": [
    {
      "code": "invalid_product_for_seal",
      "message": "Site seals are not supported for this product."
    }
  ]
}
```

**400 Bad Request (Upload failed)**

```json
{
  "errors": [
    {
      "code": "upload_failed",
      "message": "Upload failed."
    }
  ]
}
```


## Path parameters

<table>
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>order_id</td>
<td>required</td>
<td>ID of the order associated with the seal. Must be a Secure Site or Secure Site Pro certificate order.</td>
</tr>
</tbody>
</table>