Update site seal settings
PUT https://www.digicert.com/services/v2/order/certificate/{{order_id}}/site-seal
Use this endpoint to update the settings for a site seal.
DigiCert Smart Seal
Secure Site and Secure Site Pro SSL/TLS certificates support the option to display a DigiCert Smart Seal on your website. The DigiCert Smart Seal is enabled for Secure Site and Secure Site Pro certificates when the seal_number
parameter is set to a value of 18
. To switch to a basic site seal, set the seal_number
parameter to a value of 16
(GeoTrust) or 17
(Thawte).
Updating your site seal
Some modifications, such as changing the size of the site seal, do not require you to reinstall the site seal code.* Changes automatically appear within two hours of submitting the update. However, if you modify the hover effect, you must reinstall the site seal code for those changes to take effect on your website.
Hover effect modifications include:
Enabling or disabling the Smart Seal hover effect (
seal_hover
).Using the Smart Seal with the hover effect enabled, and then switching to a basic site seal (see DigiCert Smart Seal above).
Related topics
Note
*On March 25, 2021, DigiCert improved how CertCentral stores your site seal settings. Now, you can update most of the settings for your site seal without replacing the site seal code on your website (see Updating your site seal). This change affects all site seal codes you receive and implement after March 25, 2021.
For codes you received and implemented before March 25, 2021:
If you don’t change the settings for your site seal:
No action is required.
Your existing site seal code will continue to work as expected.
If you update the settings for your site seal via CertCentral or the Services API:
You must replace the site seal code on your website for those changes to appear.
After you replace the seal code on your website, you can update the settings for the seal by changing those settings within CertCentral, or by using the Update site seal endpoint.
Changes may take up to two hours to appear on websites that use the new seal code.
Example requests and responses
Path parameters
Name | Req/Opt | Description |
---|---|---|
order_id | required | ID of the order associated with the seal. |
Request parameters
Note
Parameters with an asterisk (*) are DigiCert Smart Seal features.
Name | Req/Opt | Type | Description |
---|---|---|---|
seal_number | optional | integer | Number that identifies the type of seal to display. Allowed values:
Note:
|
seal_size | optional | string | Site seal size. Allowed values:
|
seal_hover* | optional | boolean | If Note: When you enable or disable the hover feature, you must update the site seal code on your website. |
seal_autoplay* | optional | boolean | If Note: To enable this feature, |
seal_use_logo* | optional | boolean | If |
display_malware_scan | optional | boolean | If Note: This feature is only available for Secure Site Pro and Secure Site certificates. |
display_ct_log | optional | boolean | If Note
|
display_pci_scan | optional | boolean | If Note
|
display_blocklist_check | optional | boolean | If Note: This feature is only available for Secure Site Pro and Secure Site certificates. |
display_verified_customer | optional | boolean | If |
Response parameters
Note
Parameters with an asterisk (*) are DigiCert Smart Seal features.
Name | Type | Description |
---|---|---|
order_id | integer | ID of the order associated with the site seal. |
product_name_id | string | Product ID for the type of certificate on the order. See Glossary - Product identifiers. |
seal_hash | string | Site seal hash. |
seal_number | string | Number that identifies the type of seal to display. Possible values:
*Note: On October 17, 2023, DigiCert will replace the Norton site seal image with our DigiCert site seal image wherever it appears on websites secured by Secure Site or Secure Site Pro TLS certificates. |
seal_size | string | Site seal size. Possible values:
|
seal_hover* | boolean | If |
seal_autoplay* | boolean | If Note: To use this feature, |
seal_use_logo* | boolean | If |
display_malware_scan | boolean | If Note: This feature is only available for Secure Site Pro and Secure Site certificates. |
display_ct_log | boolean | If Note
|
display_pci_scan | boolean | If Note
|
display_blocklist_check | boolean | If Note: This feature is only available for Secure Site Pro and Secure Site certificates. |
display_verified_customer | boolean | If |
eligible_ct_log | boolean | If Note: CT Log monitoring is only available for Secure Site Pro certificates. |
eligible_blocklist_check | boolean | If Note: Blocklist check is only available for Secure Site Pro and Secure Site certificates. |
eligible_pci_scan | boolean | If Note: PCI compliance scans are only available for Secure Site Pro and Secure Site EV certificates. |
ct_log_enabled | boolean | If Note: CT Log monitoring is only available for Secure Site Pro certificates. |
pci_scan_enabled | boolean | If Note: PCI compliance scans are only available for Secure Site Pro and Secure Site EV certificates. |
seal_code | string | Site seal embed code, formatted as an HTML string. |
seal_logo | string | SVG data for the site seal logo, formatted as an XML string. Note: Seal logo is only available for Secure Site Pro and Secure Site certificates. |