Skip to main content

​
What You’ll Learn

  • Creating a Fathom API token
  • Connecting Fathom to MainWP Dashboard
  • Assigning Fathom sites to child sites
  • Viewing visitor data and widgets
  • Including Fathom data in Pro Reports
Integration Add-on - This add-on extends MainWP to work with Fathom Analytics. It requires a connected Fathom account with sites available to assign in MainWP.
The Fathom Extension for MainWP simplifies accessing Fathom data for all Child Sites within your MainWP Dashboard. It adds global and individual widgets that display visitor counts and valuable insights, empowering you to make informed decisions for your Child Sites.

​
Use this Extension To Track:

  • Views
  • Users
  • Unique pages view
  • Average Engagement time
  • Visitors by Country
  • Visitors by Page
  • Visitors by Device
  • Views by Referrers
  • Visitors by Browsers

​
Establishing a connection with a Fathom Account

1

Navigate to https://app.usefathom.com/api

Navigate to https://app.usefathom.com/api
2

Click the Create New button to create an API token

Click the Create New button to create an API token\Fathom API page with Create New button to generate API token
3

Give the key a name, set Permissions to Admin key, and click the Save change button

Give the key a name, set Permissions to Admin key, and click the Save change button\Fathom API token creation form with name field and Admin key permission
4

Navigate to MainWP Dashboard > Add-ons > Analytics > Fathom > Add Account

5

Paste in the API token and click the Connect Account button

Paste in the API token and click the Connect Account button\MainWP Fathom account connection page with API token field and Connect Account button
The Fathom Extension doesn’t allow you to insert the Fathom Analytics tracking code on your child sites. To do that, you will need to add the code manually or use a third-party plugin.

​
Assigning sites from your Fathom Account to Child Sites in your MainWP Dashboard

1

Go to MainWP Dashboard > Sites > Manage Sites

2

Locate the desired child site and click the Edit action

Locate the desired child site and click the Edit action\Animation showing how to access the Edit action for a child site
3

Locate the Fathom section

4

Select the correct Fathom site from the dropdown menu

5

Click the Save Settings button

Click the Save Settings button\Animation showing Fathom site selection and saving settings
6

Repeat the process for all your child sites

7

When you are done, you will see those sites in the dropdown on the Add-ons > Analytics > Fathom > Visitor Data page

When you are done, you will see those sites in the dropdown on the Add-ons > Analytics > Fathom > Visitor Data page

​
Fathom Visitor Data

After you connect your Fathom Analytics account and assign Fathom sites to your child sites, you will be able to see all Fathom Analytics data on the Add-ons > Analytics > Fathom > Visitor Data page. Animation showing Fathom Visitor Data page with analytics widgets You can disable and enable widgets in Page Settings, and you can re-arrange them in any way you wish. Animation showing how to rearrange widgets on the Fathom page

​
Refreshing Fathom data

Fathom data is cached in your MainWP Dashboard so that pages load quickly and so the Fathom Aggregation API isn’t called on every page view. The cache is refreshed automatically based on the Data refresh frequency setting, and you can also refresh it on demand.

​
Data refresh frequency

Set how often MainWP fetches fresh stats from your Fathom account:
1

Go to Add-ons > Analytics > Fathom > Settings

2

Choose a value for Data refresh frequency

Available options are Every hour, Every 3 hours, Every 9 hours, Every 15 hours, Every 18 hours, and Every 24 hours.
3

Click Save Settings

If you have many connected child sites or are close to your Fathom API rate limit, choose a longer interval. The default cadence is suitable for most installs.

​
Refresh Data button

Use the Refresh Data button to force an immediate update outside of the configured refresh frequency. It clears the Fathom stats cache and re-fetches data from Fathom for all assigned sites.
  • On the Settings tab, click the Refresh Data button next to Save Settings.
  • On the Visitor Data tab, click the Refresh Data button to reload the page with fresh stats.
Use this after assigning new Fathom sites to child sites, or whenever you want to see the latest numbers without waiting for the next scheduled refresh.

​
Display interval

The Display interval setting on the Settings tab controls the time range shown in Fathom widgets and on the Visitor Data page. Choose Week or Month depending on the reporting window you want to see by default.

​
Removing a connected Fathom account

When you remove a connected Fathom account from MainWP, the extension automatically clears the Fathom site assignments from your child sites and removes the related cached stats. You don’t need to manually clean up child site settings after disconnecting an account.

​
Widgets

The Fathom widget will be added to the Overview page and on the Individual Child site Overview page. As always, the widgets can be enabled or disabled in Page Settings, and they can be re-arranged however you wish. Fathom widget on the Overview page displaying visitor statistics

​
Fathom data in Pro Reports

Fathom data can be easily included in Pro Reports by selecting it from the Report Data section of the Pro Reports.\ Pro Reports Report Data section with Fathom data option selected Fathom data can also be included using tokens. You can find a list of all available tokens here: Available Pro Reports Tokens For more information about Pro Reports and the use of tokens please refer to this KB: Pro Reports Extension Overview