Organization settings
      Back to home
      1. Help Center
      2. Organization settings

      Domain management

      Domain Management lets you create and manage custom and managed domains across Didomi products. It ensures that domains are correctly set up before being used - for example, to load a Preference Center site or serve the CMP SDK. The system checks domain configuration, DNS propagation, and usage rules before allowing a domain to be used by Didomi products.

      Domain types and usage

      There are two types of domain usage in Didomi:

      1. Load the Didomi SDK

      • Loads the Didomi SDK.
      • Can be used for Consent Notices, Preference and Privacy request widgets.
      • Not linked to a specific widget.
      • One domain can load several products at once.
      • The domain is included in the snippet code used to load and display the widget.

      2. Server a hosted page

      • Loads a webpage hosted by Didomi, such as the Preference Center or a DSAR form.
      • Can be used for Preference and Privacy request widgets.
      • Linked to one widget only.
      • Must be detached from the widget before it can be deleted.
      • Can only be used by one widget at a time.
      • The domain is the URL used by end-user to access the widget.

      Access the Domain List

      Access to the Domain list requires a specific role. Make sure you have the necessary permissions before proceeding.

      To access the Domain list:

      1. Click on My Organization
      2. Click on Organization Settings
      3. Go to the Domains tab

      You can find the following information in the Domain list:

      Error Description
      Status The current status of the domain (e.g., Ready, Draft, Failed, Verifying, Deleting).
      Name Full domain name (e.g., cmp.domain.com).
      Usage Indicates how the domain is used (e.g., SDK, Webpage).
      Type DNS record type, always NS (Name Server).
      Value NS record values to enter in your DNS provider.
      Actions Icons for copy NS values, edit the domain, or delete the domain (varies depending on domain status).

      Create a new domain

      To create a new domain, click the Add domain button in the Domain list.

      Convert to GIF July 02 2025

      1. Register a domain name
      2. Select the usage of the domain (Load the SDK or Load a webpage)
      3. Create the NS record
        • You must create the NS records with your DNS provider, and they must be fully propagated before proceeding.
          • If the DNS is ready, continue to the next step and submit the domain.
          • If the DNS is not ready, save the domain as a draft and return later to complete the setup.
      4. Submit the domain for provisioning.

      Edit a draft domain

      To edit a domain in draft status, click the Pencil icon next to the domain in the list.

      Once your DNS is ready, update the draft domain to complete the setup so we can proceed with provisioning.

      Delete a domain

      You can delete a domain by clicking on the Trash button in the Domain list.

      • For SDK domains, the domain can be deleted. Make sure to decommission the widget before proceeding.
      • For Webpage domains, the domain must be unattached from the widget before it can be deleted.

      Use a domain with a product

      You can use the domain to load the CMP SDK for consent notices, the PMP SDK for preferences or privacy widgets, and also to serve the Preference Center as a standalone webpage.

      Summary of domain capabilities

      Feature Load the SDK (usage cmp in the API) Load a hosted page (usage preference-center in the API)
      Loads Didomi SDK (CMP, PMP, DSAR) ✅ ❌
      Loads Preference Center / DSAR UI ❌ ✅
      NS record validation required ✅ ✅
      Can be reused across products ✅ ❌
      Tied to a widget ❌ ✅
      Must be detached from the widget before deletion ❌ ✅