Fathom Integration
Check every client site’s Fathom visitors, views and traffic sources from your MainWP Dashboard, and add the numbers to client reports with Pro Reports.

Fathom Analytics stats beside the sites you maintain
The Fathom Integration is a Pro MainWP add-on that shows Fathom Analytics visitor stats for all your child sites in your MainWP Dashboard. You connect your Fathom account once, assign a Fathom site to each child site, and read views, visitors and traffic sources in Dashboard widgets and on one Visitor Data page.
Leaving MainWP to check traffic
Checking a client site’s traffic means leaving MainWP, opening Fathom and finding that site there. The Fathom Integration brings each child site’s Fathom stats into your MainWP Dashboard, on the overview pages and on a Visitor Data page where you pick the site from a dropdown.
Features
The Fathom Integration covers where the stats appear, how fresh they are and how they reach client reports.
| Feature | What it means for you |
|---|---|
| Visitor Data page | See the Fathom stats for every assigned child site under Add-ons > Analytics > Fathom > Visitor Data. Pick a site from the dropdown, and turn widgets on or off and rearrange them in Page Settings. |
| Overview widgets | A Fathom widget shows up on the MainWP Overview page and on each child site’s Overview page. You can turn it on or off and move it in Page Settings. |
| Visitor metrics | See how many people are on each site right now, then track views, users, unique page views, average engagement time and bounce rate, plus visitors by country, page, device and browser, and views by referrer. |
| Site assignment | Link each child site to the matching site in your Fathom account from the child site’s Edit page. |
| Data refresh frequency | Stats are cached in your Dashboard and refreshed on the schedule you pick: every 1, 3, 9, 15, 18 or 24 hours. |
| Refresh Data button | Clear the cache and fetch fresh stats for all assigned sites right away, from the Settings tab or the Visitor Data tab. |
| Display interval | Choose Week or Month as the time range that widgets and the Visitor Data page show by default. |
| Pro Reports data | Add Fathom data to client reports from the Report Data section of Pro Reports, or with tokens such as [fathom.visits], [fathom.visitors], [fathom.pageviews], [fathom.avg.time], [fathom.bounce.rate] and [fathom.visits.chart]. |
Requirements
You connect your Fathom Analytics account in your MainWP Dashboard. The Fathom Integration reads stats from that account, so each child site needs the Fathom tracking code.
| Item | Requirement |
|---|---|
| License | MainWP Pro |
| Fathom account | A paid Fathom Analytics subscription (Fathom pricing) with your client sites added in Fathom |
| Fathom API token | An API token created in Fathom with Permissions set to Admin key |
| Child sites | The Fathom tracking code on each child site, added by hand or with a third-party plugin |
| Client reports (optional) | Pro Reports to include Fathom data in reports |
Setup: connect your account and assign sites
Setting up the Fathom Integration has three parts: the API token, the site assignments and the refresh schedule.
Connect your Fathom account
- In Fathom, go to app.usefathom.com/api and click Create New to create an API token.
- Give the key a name, set Permissions to Admin key, and click Save change.
- In your MainWP Dashboard, go to Add-ons > Analytics > Fathom > Add Account.
- Paste in the API token and click Connect Account.
Assign Fathom sites to your child sites
- Go to Sites > Manage Sites, find the child site, and click the Edit action.
- In the Fathom section, select the matching Fathom site from the dropdown.
- Click Save Settings, then repeat for your other child sites.
- The assigned sites now show up in the dropdown on Add-ons > Analytics > Fathom > Visitor Data.
Choose how often stats refresh
- Go to Add-ons > Analytics > Fathom > Settings.
- Choose a Data refresh frequency and, under Display interval, Week or Month.
- Click Save Settings.
Full instructions, including widgets and Pro Reports tokens: Fathom Integration documentation.
Fast pages, fresh numbers when you need them
The Fathom Integration keeps a copy of your stats in your MainWP Dashboard and refreshes it on the schedule you choose, so pages and widgets load quickly. Need the latest numbers before a client call? Click Refresh Data to pull fresh stats right away.
Fathom FAQ
What do I need to pay for?
The Fathom Integration is part of MainWP Pro, so Pro members already have it. Fathom Analytics is a separate subscription you hold with Fathom; see Fathom pricing. One Fathom account can cover many client sites, and you connect it to MainWP once.
How often does the Fathom Integration update its stats?
The Fathom Integration refreshes its cached stats on the Data refresh frequency you set, from every hour to every 24 hours. For the latest numbers right away, click Refresh Data on the Settings or Visitor Data tab.
Can my staff see only their own clients’ stats?
Yes. With the Team Control add-on, staff users see Fathom stats and widgets only for the child sites they can access. Connecting accounts and changing settings stay with administrators.
What happens to child site settings when I remove a Fathom account?
When you remove a connected Fathom account, the Fathom Integration clears that account’s Fathom site assignments from your child sites and removes the related cached stats, so there is nothing to clean up by hand.
Where do I get support?
The Fathom team handles issues with Fathom Analytics itself. MainWP support handles issues with the integration.




