Use your own domain

A default URL is assigned to your widget:

https://organization-widget-id.preference-center.org/

We recommend using your own domain name instead, such as https://privacy.company-name.com

To use a domain in a widget:

• The domain must already exist (see how to create a domain).

• The domain must be in Ready status.

• The domain must have the correct usage (Load a webpage or preference-center in the API).

• The domain must not be assigned to another widget.

Update the widget with the custom domain

You can update the widget with a custom domain by sending a PATCH request to the /widgets/{id} endpoint.

Set the domain property to custom and include the custom_domain_id property with the domain ID (or domain name) you want to assign.

PATCH https://api.didomi.io/widgets?organization_id=YOUR_ORG_ID

{
  "domain": "custom",
  /**
   * custom_domain_id corresponds to your custom domain
   * ex: preferences.didomi.io
   */  
  "custom_domain_id": "String"

}

To apply your changes, you must deploy the widget.

If you struggle with configuring your custom domain, send an email to [email protected] or to the person you have been in touch with at Didomi to let us know what custom domain you will be using and that the setup is done on your side.