If you have a WordPress website, you can either copy/paste your Fathom script into your footer theme file, or use our WordPress plugin.
By using Fathom Analytics for WordPress you can view your Fathom dashboard directly within your WordPress admin area (cool, right?).
In order to show your Fathom dashboard inside WordPress, your dashboard has to be shared.
Here’s how you set it up:
- Download the Fathom Analytics plugin
- Log into your WordPress admin area
- Go to
- Search for
Install Now, then
- Go to
- In the
Site IDfield, type in your Site ID. If you don’t know your Site ID, log into Fathom, go to
Settings, click on your site name, and your Site ID will be located below the site name
- If your dashboard is public, leave the
Fathom Share Passwordfield blank. If your dashboard is privately shared with a password, then type in the share password Note: site sharing must be enabled for you to view your dashboard within WordPress
- To prevent Fathom from collecting visit data for logged-in WordPress users, check the boxes for the user roles you want to exclude. Leave them unchecked if you don't want to exclude any roles.
- To display your Fathom dashboard within WordPress, ensure the
Display Analytics Menu Itemcheckbox is selected.
Save Changes, and you'll find the
Fathom Analyticsoption in the menu on the left-hand side of your WordPress admin area.
Following the above steps will automatically place the Fathom script into the header of every page on your WordPress site.
Download Fathom Analytics for WordPress here.
If your WordPress site isn't displaying new analytics data, even after you've installed our plugin, read this
WordPress can sometimes be tricky because there are many moving parts (plugins, themes, extra code, etc). If you've installed our plugin, and followed the setup instructions above, and you still aren't seeing analytics data on your dashboard, it's likely due to one of these things:
- You're using a caching plugin. See the section below on caching/optimizer plugins. If yours isn't listed, look for a way within that plugin to "exclude" our script from being cached, as our script loads from our servers, not from your local install (that's why our script is so fast).
To exclude our script from any of the above scenarios, add
cdn.usefathom.com/script.js to the exclusions.
If you are not seeing your own visits to your site:
- Make sure you haven't excluded your user role by going to the Fathom settings in your WordPress admin area and checking whether you have selected your user role option under
- Make sure you haven't blocked your IP in your site firewall settings.
- Make sure you haven't blocked yourself in your browser console.
The Fathom Analytics dashboard page is showing a 404 error in WordPress
If you are seeing a 404 page when trying to view your dashboard from within WordPress, it's because you haven't either haven't set your dashboard to shared in your site's settings or you haven't entered the password into the
Share password field (see step 8 from the setup instructions above).
WordPress caching and site optimizer plugins that are auto-excluded from caching the Fathom Analytics script:
In the past, we've had issues with certain 3rd-party WordPress plugins caching our script, causing it to not function correctly. So, we've implemented a way for our script to avoid being cached and/or bundled by those plugins.
Here's the list of caching plugins from which our script is automatically excluded:
- WP Rocket
- SiteGround Optimizer
- W3 Total Cache
- WP Optimize
To learn about all the options we offer, read our advanced documentation here.
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.