In this article

Applies to MSP accounts with a legacy Whitelabel custom CNAME domain configured. MSP accounts without a custom CNAME domain have been migrated to MSP Branding.

A custom domain enables MSP clients to access the DNSFilter dashboard through a subdomain branded to the MSP, rather than the default app.dnsfilter.com URL. Setting up a custom domain is part of the whitelabeled DNSFilter experience.

For details on all whitelabel settings, follow the MSP Whitelabel Configurations guide.

See the image below for an example of a client's browser when a custom domain and logo is used.

Set up a custom domain in two steps:

• Add a CNAME with your domain registrar for the custom whitelabel domain that points to cname.netalerts.io  
• Enter your custom domain into the Custom Domain Mapping (CNAME) section on the Whitelabel configuration page

After configuration, DNSFilter staff will verify your CNAME change and update our servers in 1-2 business days.

Step one: Add a CNAME with your domain registrar

Follow these steps to create a new CNAME for the customer whitelabel domain. This CNAME should be unique/not too generic to avoid issues. 

✍️ Every domain registrar has slightly different processes to complete this step. See your provider's documentation for specific guidance.  

1. Login to your domain registrar
2. Create a new CNAME record - this is the domain to the custom whitelabel interface, e.g. demomsp.filterdns.com
   1. Hostname or prefix (without the domain name), e.g. demomsp
   2. CNAME destination, alias, or value - point the CNAME to cname.netalerts.io
   3. TTL or time to live - the typical default is 1 hour

Step two: Enter the custom domain in the DNSFilter dashboard 

Follow these steps to add the CNAME domain to the DNSFilter dashboard.

1. From the DNSFilter MSP dashboard, select MSP
2. Select Whitelabel
3. Toggle on Enable Whitelabel
4. Enter a Dashboard Name. The name associated with the dashboard when accessed via customer domain. This is typically your company name
5. Enter the Custom Domain Mapping. This is the CNAME's full domain, e.g. demomsp.filterdns.com 

Select Save or continue to fill in the Whitelabel configuration to add Custom Logos (remember to use a transparent background) and email configurations. 

Once saved, a request auto-populates for the DNSFilter Support team to complete the Custom Domain configuration, which typically takes 1-2 business days. They will contact you once the process is complete. 

Once confirmed, your clients will then be able to login to your custom domain.