Support home / Script /

Script settings

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. You can read much more about this here.

In order to get the benefits of our new script updates, you need to re-setup your Fathom embed code on your site. 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 Click on the site name, then Setup a custom domain and the button will change to: Script settings.

If you want to use custom domains, see our documentation on this.

With our new script, there are several powerful settings you can use to make your site’s data more accurate and more focused on what you want to collect. Here are the features you’ll have available:

EU isolation

You can learn more about EU isolation here, and you can set it up on your Script settings page, under the Custom domains section. By default, we enable EU isolation are therefore compliant with privacy laws and process EU visits in the EU and all other visits in the US. If you want to only process all visits in the EU, set EU isolation to Extreme.

Allowed domains

If you want to only allow data to be collected from specific domains, add them to the Allowed domains section of your script settings page.

This is useful if you want to not collect data from your local development environment, or if you are worried that other people may be using your script (by accident or otherwise).

We support wildcards here, so you can use * to allow both and (useful if you don’t use canonicals). You can also do things like *, which, if you have user-generated subdomains, would allow,, etc.

IP blocking

If you want to block visits from a specific IP address (your own or someone else’s), you can add the IP to your block list. Note, if you want to not track yourself in Fathom, we also offer another method.

You can also use wildcards in IP blocking, if you want to block your entire company (for example) and they’re use similar IP addresses, like the same Class C block, for example: 1.1.1.XXX. In this case, you’d add 1.1.1.* and click Block IP.

We also support IPv6 addresses, for example: 2606:4700:4700::1111. You can add an IPv6 to your block list, and wildcards are also supported here.

Note, visitors with these blocked IP addresses will still be able to see your website, but their pageviews and analytics data won’t show up in Fathom.

Country blocking

Similar to IP blocking, you can block specific visits from anyone within a country by setting it up on your Script settings page.

Why would you do this? Say you’re getting a ton of traffic from a country that your business doesn’t serve, simply add that country to your block list. They’ll still be able to see your website, but their pageviews and analytics data won’t show up in Fathom.

Note, visitors from these blocked countries will still be able to see your website, but their pageviews and analytics data won’t show up in Fathom.

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.