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.

Troubleshooting