Custom domains (updated)
While we believe that ad-blocking browser extensions are great, useful and help people hide their personal data from big tech companies, we also believe that since our own product is privacy-focused, our customers should be able to stop their tracking script from being blocked by ad-blockers.
We’ve recently changed how custom domains and our script settings work, to be much better for: bypassing ad-blockers, allowing domains, blocking IP addresses and countries, and more.
In order to get the benefits of our new script updates, you need to re-setup a custom domain for your embed code. Note, that if you don’t want to do this (and don’t want to be able to use these features, you can leave your script as-is and it will continue functioning).
The first step to start using our new custom domains and updated script settings is to go to
Sites and click on the site name you wish to update.
For this example, let’s use
yoursite.com. Click on the site name, then
Setup a custom domain. If you've already enabled custom domains, just add a custom domain (or a new one), then click
Script settings. To learn more about our script settings, read about it here.
Enable custom domains
Before you do anything, you need to enable custom domains. To enable custom domains, click on the purple button named
Setup a custom domain from your site settings. If it's already enabled, you'll just see a form to add a domain or subdomain.
Once enabled, you will be able to setup your custom domain to load our script.
You have two options here:
- Random: this randomly generates a subdomain for you, which is best to avoid ad-blockers. For example:
- Specific: if you want to use a specific subdomain, you can type one in. AVOID subdomains like
fathomas these are easily guessed and blocked by adblockers.
If your site is
yoursite.com, then type that into the box and click
Add domain. You’ll then see a modal window with some DNS details, add the CNAME with the VALUE to your DNS records for your domain.
If your site is
yoursite.com, then create a unique subdomain, like
a.yoursite.com and type that whole thing into the box and click
Add subdomain. You’ll then see a modal window with some DNS details, add the CNAME with the VALUE to your DNS records for your domain.
Remember, if you are using a specific subdomain, try to be as unique as possible.
Once you've created the DNS records
Whether random or specific, once you’ve added these, click
I have created these DNS records, you’ll be all set. We’ll send you an email once the DNS records have finished propagating, and we have successfully issued an SSL certificate for the domain, and your new subdomain will be ready to use (and will show up were you see your embed script). For example:
<script src="https://enchanting-curious.yoursite.com/script.js" data-site="EXAMPLE" defer></script>
If you’re waiting for your DNS to propagate, you can always use our simple ad-blocker bypass script URL in the interim, you’ll just have to update your embed code again once your custom domain is ready to go (no data will be lost if you update your embed script). You never lose traffic or have historical data deleted when you change your script URL.
Use the same custom domain on any of your sites
If you've created a custom domain in Fathom, and it's showing as
active, you can use it on any site in your account. Just make sure you change the SiteID to the correct one for each site.
Note: If you use the same custom domain across multiple domains you run the risk of an ad-blocker blocking your custom domain across ALL your sites (which is why we don't always recommend doing this). You also lose the ability to be site-specific with features like IP and country blocking.
If your custom domain is blocked
On the off-chance that ad-blockers add your new custom domain to a block list (it’s unlikely, but it can happen if your site is popular), all you need to do is add your domain again, which generates a new CNAME and VALUE, and use that instead. You’ll instantly be back to bypassing ad-blockers, and won’t lose any data in the process.
How to add a custom CNAME on popular domain registrars
Every domain registrar is different in terms of editing DNS records, but here are links to a few popular ones:
- Adding a CNAME in Godaddy
- Adding a CNAME in CloudFlare (turn off proxy, the little orange cloud)
- Adding a CNAME in Hover
- Adding a CNAME in NameCheap
If you still have questions or require help with anything, please reach out to us and we'll happily get things sorted out for you.