How to Set Up a First-Party CMP Domain

Serve your UniConsent consent banner from your own domain (e.g., mycmp.example.com) instead of the default cmp.uniconsent.com. First-party serving improves page load performance and keeps all requests on your own domain for better privacy compliance.

Prerequisites

  • You must be on a Pro plan or higher, or be a VIP user.
  • You need access to your domain's DNS settings.

Step 1: Open Project Settings

  1. Go to your project in the UniConsent dashboard.
  2. Click the Install & Setup tab.
  3. Scroll down to First-Party CMP Domain.

Step 2: Enter Your Domain

Enter the subdomain you want to use, for example mycmp.example.com or consent.example.com.

Click Setup Domain. UniConsent will provision an SSL certificate for your domain.

Step 3: Add DNS Records

After provisioning, you will see the required DNS records. Add them at your domain provider:

TypeNameValue
CNAMEmycmp.example.comconsent.preference-center.com
TXT(if shown)(certificate validation value)
TXT(if shown)(ownership validation value)

Important: If your domain is on Cloudflare, set the CNAME to DNS only (grey cloud, no proxy).

Step 4: Verify DNS

Click Verify DNS to check the status. Once the SSL certificate is active, the status will change to Active.

Step 5: Update Your Tag

Once the domain is active, the install tag on the Settings tab will automatically update to use your custom domain:

<script src="https://mycmp.example.com/v2/stub.min.js"></script>
<script async src="https://mycmp.example.com/v2/YOUR_LICENSE_ID/cmp.js"></script>

Replace the old tag on your website with this new one.

Removing a Custom Domain

You can remove the custom domain at any time from the Install & Setup tab. The tag will revert to the default cmp.uniconsent.com domain.

Troubleshooting

  • DNS not found: Wait up to 24 hours for DNS propagation, then try verifying again.
  • SSL pending: Ensure TXT validation records are added correctly.
  • Cloudflare proxy: Disable the orange cloud (proxy) on the CNAME record. Use DNS only.