Connect Google Analytics, Plausible or Umami

WP Foreman doesn’t add another tracking script to your sites. It reads the numbers from the analytics you already use and shows them on each site’s Analytics page, next to its backups and updates.

Supported: Google Analytics 4, Plausible (plausible.io or Community Edition) and Umami (Umami Cloud or self-hosted).

Google Analytics (GA4)

1. Open Settings › Analytics and click Connect Google Analytics.
2. Sign in with the Google account that can see your GA4 properties, and allow See and download your Google Analytics data. That’s read-only: WP Foreman can’t change anything in Analytics.
3. Back in WP Foreman, open a site, choose Analytics, and pick its property from the list (WP Foreman suggests the one whose name looks like the site). Or type the property ID: numbers only, from GA Admin › Property details. The G-XXXX measurement ID won’t work here.

One Google connection covers every property that account can see. If a client owns their own GA property, ask them to add your Google account as a Viewer in GA Admin › Property access management.

Plausible or Umami, step 1: connect your account

1. Open Settings › Analytics and click Connect Plausible or Umami.
2. Pick Plausible or Umami, then Their cloud or Self-hosted.
3. Paste the key (see the table below). For self-hosted, also enter its address, starting with https://.
4. Click Connect. Umami keys are checked straight away. Plausible keys are checked when you pick a site, because Plausible’s API needs a site to test against.

One connection covers every site in that account, so most people connect once.

Plausible or Umami, step 2: pick each site

1. Open a site and choose Analytics in the left menu.
2. Choose the account. For Umami, pick the website from the list; WP Foreman suggests the one whose domain matches the site. For Plausible, type the site’s domain exactly as it appears in Plausible (it’s pre-filled from the site’s address).
3. Click Connect. WP Foreman checks it can read that site, then shows its traffic.

To change it later, click Change source. Switch off stops showing traffic for that site.

What WP Foreman can and can’t do

• It only reads totals, daily numbers, top pages and top sources. It never changes settings, goals or sites in your analytics.
• Keys and passwords are stored encrypted and are never shown again after you save them. To change one, disconnect and connect again.
• Self-hosted addresses must be public https:// addresses. Private and local network addresses are refused.
• Numbers are fetched when you open the page and kept for 15 minutes, to stay well inside Plausible’s and Umami’s rate limits.

If you disconnect by mistake

Disconnecting a connection unlinks every site that used it, so their dashboards and client reports lose their visitor numbers. WP Foreman remembers which property each site had. Connect the same account again (the same Google account, or the same Plausible or Umami server) and those sites are linked back automatically, with nothing to pick.

Until then:

• The morning report lists each site under Needs you, and does the same when a connection stops working (for example, access was removed on the Google account).
• Scheduled reports aren’t emailed to clients without their visitor numbers. The rule still makes the report, emails you to say it was held and why, and notes it in the site’s log. Fix the link, then make the report again and send it from the site’s Reports page.

Switching Analytics off on one site (Switch off on its Analytics page) is treated as on purpose: that site isn’t relinked later and its reports aren’t held.

Troubleshooting