WordPress

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:

1. Download the Fathom Analytics plugin
2. Log into your WordPress admin area
3. Go to Plugins, Add New
4. Search for Fathom Analytics
5. Click Install Now, then Activate
6. Go to Settings, then Fathom Analytics
7. In the Site ID field, 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
8. If your dashboard is public, leave the Fathom Share Password field 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
9. 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.
10. To display your Fathom dashboard within WordPress, ensure the Display Analytics Menu Item checkbox is selected.
11. Click Save Changes, and you’ll find the Fathom Analytics option 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:

1. 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).
2. You’re using a plugin that combines our javascript with local scripts. See the section below on caching/optimizer plugins. If yours isn’t listed, look for a setting in that plugin to “exclude” our script from being combined with any other javascript, as our script will not work if it’s combined with local scripts (since it’s not local).
3. You’re using a plugin that is minifying our javascript with local scripts. See the section below on caching/optimizer plugins. If yours isn’t listed, look for a setting in that plugin to “exclude” our script from being minified with any other javascript, because our script will not work if it’s minified locally (since it’s not local).

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:

1. 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 Exclude Roles.
2. Make sure you haven’t blocked your IP in your site firewall settings.
3. 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
• Hummingbird
• W3 Total Cache
• WP Optimize

Track custom events for authors

If you’d like to know which authors are getting the most traffic on your site, you can setup a custom event and add a snippet to your functions.php theme file to track this. The code below will create a custom event per author (once each author has more than 1 pageview) and add an event completion each time a post (not pages) has been viewed, and organize each post view by author in your events:

function add_fathom_author_tracking() {
    if (is_single()) {
        $author_nickname = get_the_author_meta('nickname');
        ?>
        <script>
        window.addEventListener('load', (event) => {
                fathom.trackEvent('Author: <?php echo esc_js($author_nickname); ?>');

        });
        </script>
        <?php
    }
}
add_action('wp_footer', 'add_fathom_author_tracking');

The above assumes you have access to edit the functions.php file in your theme. If you’re using a theme that doesn’t allow editing that file, a plugin like Code Snippets can help (note that we cannot support plugins like this one, it’s out of scope of our Fathom support). The above code does not track tag pages, category pages, archive pages, or non-single post pages. It will only track blog post pages with authors.

Further customization

To learn about all the options we offer, read our advanced documentation here.