EU DPA declares Google Analytics illegal because it runs on US cloud providers. Fathom is a Canadian company, and all of your EU traffic never leaves German-owned servers.
Support home / Script /

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 Settings then 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:

  1. Random: this randomly generates a subdomain for you, which is best to avoid ad-blockers. For example: elegant-paul.yoursite.com
  2. Specific: if you want to use a specific subdomain, you can type one in. AVOID subdomains like stats or fathom as these are easily guessed and blocked by adblockers.

Random subdomains

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.

Specific subdomains

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:

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.