Assign domains to widgets

Load the webpage

The Preference Manage Platform lets you customize the domain where your widget is hosted. By default, Didomi generates a subdomain on preference-center.org (or managed domain), but you can change it to match your company name (or custom domain).

This domain becomes the public URL of your Preference Center or DSAR widget. The platform ensures the domain is correctly created and linked before the widget can be deployed and made available to your users.

How to configure a custom domain

To use a domain in a widget:

• The domain must already exist.
• 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.

To customize the domain where your widget hosted:

1. Open the widget editor and go to the Hosting tab.
2. In the right-hand panel, find the Load the webpage section and click on Use custom domain.
   1. If a domain is available, select the domain.
   2. If no domain is available, click on Create a domain.
3. Save your widget.

How to configured a managed domain

To customize the subdomain of a managed domain where your widget will be hosted:

1. Open the widget editor and go to the Hosting tab.

2. In the right-hand panel, find the Load the webpage section and click on Use managed domain.

3. Enter your desired subdomain in the My subdomain field.

   Refer to the section below to learn what makes a subdomain valid.

4. If the subdomain is available, you’ll be able to save your widget.

How to create a valid subdomain name?

👉 To be valid, your subdomain name must follow standard Domain rules.

• It can only contain lowercase letters, the 26 letters of the English alphabet, numbers (0-9), or hyphen/minus signs (-).
• It must start and end with a letter or number, not a hyphen.
• There can not be two consecutive hyphens.
• The entire hostname can not exceed 255 characters, and the subdomain can not exceed 63 characters.