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. Requires Fathom Analytics to be installed on your child sites.
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 > Extensions > Fathom > Add Sites page

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 Add Sites 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 3rd party plugin.

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

1

Go to the MainWP > Sites > Manage Sites page

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 Extensions > Fathom > Visitor Data page

When you are done, you will see those sites in the dropdown on the Extensions > 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 Extensions > Fathom > Visitor Data page**.** Animation showing Fathom Visitor Data page with analytics widgets You can disable and enable widgets in the Page Settings, and you can re-arrange them in any way you wish. Animation showing how to rearrange widgets on the Fathom page

​
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 the 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: [/add-ons/reporting/available-pro-reports-tokens) For more information about Pro Reports and the use of tokens please refer to this KB: Pro Reports Extension Overview