> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mainwp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fathom

> The MainWP Fathom Extension enables you to view Fathom stats for all your Child Sites in your MainWP Dashboard. It adds widgets to both the MainWP overview and individual site overview pages, making it simple to monitor your visitors' data.

<div id="addon-data" style={{display: 'none'}} data-title="Fathom" data-purchase-url="https://mainwp.com/extension/fathom/" data-pricing-tier="pro" data-bundle="MainWP Pro" data-addon-type="integration" data-version="5.0.2" data-developer="MainWP" data-changelog-url="https://mainwp.com/changelog/mainwp-fathom-extension/" data-integrates-with="Fathom Analytics" data-owned-by="Conva Ventures Inc." data-privacy-url="https://usefathom.com/privacy" />

## 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

***

<Info>
  **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.
</Info>

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/oWxZMmOdy3c" title="Fathom - Video Tutorial" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

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

<Steps>
  <Step title="Navigate to https://app.usefathom.com/api">
    Navigate to [https://app.usefathom.com/api](https://app.usefathom.com/api)
  </Step>

  <Step title="Click the Create New button to create an API token">
    Click the **Create New** button to create an API token\\

    <img src="https://mintcdn.com/mainwp/m5iWPkGmGTv3i5YV/images/add-ons/fathom-api-create-button.png?fit=max&auto=format&n=m5iWPkGmGTv3i5YV&q=85&s=c384e4fc6718b5302ef28790abdae05f" alt="Fathom API page with Create New button to generate API token" width="1193" height="759" data-path="images/add-ons/fathom-api-create-button.png" />
  </Step>

  <Step title="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\\

    <img src="https://mintcdn.com/mainwp/m5iWPkGmGTv3i5YV/images/add-ons/fathom-api-token-form.png?fit=max&auto=format&n=m5iWPkGmGTv3i5YV&q=85&s=f2df3e9f3111199aa8c541b15fdbe4cb" alt="Fathom API token creation form with name field and Admin key permission" width="1891" height="928" data-path="images/add-ons/fathom-api-token-form.png" />
  </Step>

  <Step title="Navigate to MainWP Dashboard > Add-ons > Analytics > Fathom > Add Account" />

  <Step title="Paste in the API token and click the Connect Account button">
    Paste in the API token and click the **Connect Account** button\\

    <img src="https://mintcdn.com/mainwp/m5iWPkGmGTv3i5YV/images/add-ons/fathom-add-sites-page.png?fit=max&auto=format&n=m5iWPkGmGTv3i5YV&q=85&s=d8530e836edfd8008833112d42f3a01a" alt="MainWP Fathom account connection page with API token field and Connect Account button" width="1920" height="1080" data-path="images/add-ons/fathom-add-sites-page.png" />
  </Step>
</Steps>

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

<Steps>
  <Step title="Go to MainWP Dashboard > Sites > Manage Sites" />

  <Step title="Locate the desired child site and click the Edit action">
    Locate the desired child site and click the **Edit** action\\

    <img src="https://mintcdn.com/mainwp/m5iWPkGmGTv3i5YV/images/add-ons/fathom-edit-site-action.gif?s=b6dda75b56adfef03919cd00e3eb8dde" alt="Animation showing how to access the Edit action for a child site" width="1920" height="1080" data-path="images/add-ons/fathom-edit-site-action.gif" />
  </Step>

  <Step title="Locate the Fathom section" />

  <Step title="Select the correct Fathom site from the dropdown menu" />

  <Step title="Click the Save Settings button">
    Click the **Save Settings** button\\

    <img src="https://mintcdn.com/mainwp/m5iWPkGmGTv3i5YV/images/add-ons/fathom-site-selection.gif?s=d79002c4d878abbdf30d4a853a04a079" alt="Animation showing Fathom site selection and saving settings" width="1920" height="1080" data-path="images/add-ons/fathom-site-selection.gif" />
  </Step>

  <Step title="Repeat the process for all your child sites" />

  <Step title="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
  </Step>
</Steps>

## 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.

<img src="https://mintcdn.com/mainwp/m5iWPkGmGTv3i5YV/images/add-ons/fathom-visitor-data-page.gif?s=74259335870911636cd4a53f6ca78cf9" alt="Animation showing Fathom Visitor Data page with analytics widgets" width="1920" height="1080" data-path="images/add-ons/fathom-visitor-data-page.gif" />

You can disable and enable widgets in [Page Settings](/getting-started/mainwp-user-interface), and you can re-arrange them in any way you wish.

<img src="https://mintcdn.com/mainwp/m5iWPkGmGTv3i5YV/images/add-ons/fathom-widget-rearrange.gif?s=80700699dbced0e1a91c3c0e2760c31f" alt="Animation showing how to rearrange widgets on the Fathom page" width="1920" height="1080" data-path="images/add-ons/fathom-widget-rearrange.gif" />

## 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](/getting-started/mainwp-user-interface), and they can be re-arranged however you wish.

<img src="https://mintcdn.com/mainwp/m5iWPkGmGTv3i5YV/images/add-ons/fathom-overview-widget.png?fit=max&auto=format&n=m5iWPkGmGTv3i5YV&q=85&s=bf0f2d81ac77c11d37a2284a1dedcc21" alt="Fathom widget on the Overview page displaying visitor statistics" width="1920" height="1080" data-path="images/add-ons/fathom-overview-widget.png" />

## 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.\\

<img src="https://mintcdn.com/mainwp/m5iWPkGmGTv3i5YV/images/add-ons/fathom-pro-reports-data.png?fit=max&auto=format&n=m5iWPkGmGTv3i5YV&q=85&s=9436c36a599b9828d0298a608af1fde5" alt="Pro Reports Report Data section with Fathom data option selected" width="1252" height="385" data-path="images/add-ons/fathom-pro-reports-data.png" />

Fathom data can also be included using tokens. You can find a list of all available tokens here: [Available Pro Reports Tokens](/add-ons/agency/available-pro-reports-tokens)

For more information about Pro Reports and the use of tokens please refer to this KB: [Pro Reports Extension Overview](/add-ons/agency/pro-reports-extension-overview)

***

## Related Resources

* [Analytics Add-ons](/add-ons/analytics) - Browse all analytics integrations
* [Pro Reports Extension](/add-ons/agency/pro-reports-extension-overview) - Include analytics data in reports
* [Available Pro Reports Tokens](/add-ons/agency/available-pro-reports-tokens) - Fathom tokens
