From 48884a18b88f9b40bab110eaac04e99d39dd4f0b Mon Sep 17 00:00:00 2001 From: Marko Saric Date: Tue, 22 Sep 2026 13:47:27 +0200 Subject: [PATCH] wp multisite --- docs/subdomain-hostname-filter.md | 2 ++ docs/wordpress-integration.md | 20 +++++++++++++++++++- 2 files changed, 21 insertions(+), 1 deletion(-) diff --git a/docs/subdomain-hostname-filter.md b/docs/subdomain-hostname-filter.md index 0f6cc82e..c8243556 100644 --- a/docs/subdomain-hostname-filter.md +++ b/docs/subdomain-hostname-filter.md @@ -25,6 +25,8 @@ Whatever you choose, [Consolidated Views](consolidated-views.md) let you combine Here's how to set up tracking across your domain name and its subdomains. +Using WordPress multisite? Follow the [multisite setup instructions](wordpress-integration.md#wordpress-multisite-networks) to connect each WordPress site to a shared Plausible dashboard or use separate dashboards. + ## How to set up tracking across domain and subdomains 1. [Add your domain name](add-website.md) (`yourdomain.com`) as a site to your Plausible account diff --git a/docs/wordpress-integration.md b/docs/wordpress-integration.md index 5f5c4df5..704ed201 100644 --- a/docs/wordpress-integration.md +++ b/docs/wordpress-integration.md @@ -60,6 +60,24 @@ Your site is now being tracked. You can confirm tracking from your [site setting Plugin tokens are site-specific and always start with `plausible-plugin-`. Make sure the token was created for the exact site you are connecting, and generate a new one if in doubt. ::: +## WordPress multisite networks + +You can track a WordPress multisite network in one Plausible dashboard. Install the plugin once through **Network Admin → Plugins**, then either **Network Activate** it or activate it individually on the sites you want to track. + +To send traffic from those sites to one dashboard: + +1. [Add your network's main domain](add-website.md) as a site in Plausible, for example `example.com`. +2. Open the Plausible plugin settings in each WordPress site's dashboard. +3. Enter the same main domain in **Domain Name** on every site, exactly as added to Plausible. For example, use `example.com` for both `blog.example.com` and `example.com/shop/`. +4. [Connect each site with a plugin token](#connect-with-a-plugin-token) created for that same Plausible site. +5. Visit each site while logged out of WordPress and check that its traffic appears in your Plausible dashboard. + +Network activation makes the plugin active across the network, but does not copy its connection settings to each site. Connecting only the main WordPress site is not enough. Configure each site you want included, including any sites you add later. + +The shared dashboard combines traffic from all configured sites. For subdomains or mapped domains, [filter by hostname](subdomain-hostname-filter.md#filtering-traffic-by-hostname) to see one site's traffic. For subdirectory sites, [filter by page path](pageview-goals.md#how-to-group-your-pages). Pages with the same path on different hostnames are grouped by default; [break the Pages report down by URL](top-pages.md#break-down-by-full-url) to tell them apart. + +One shared dashboard is optional. If you want separate dashboards for sites on different domains or subdomains, add each as its own site in Plausible and connect each WordPress site using its corresponding domain and plugin token. + ## Multilingual sites with WPML If you run [WPML](https://wpml.org/) in **different domain per language** mode, you can connect each language domain to its own Plausible dashboard. Other WPML setups (a language directory like `/fr/` or a language subdomain) are tracked as a single site and need no extra steps. @@ -69,7 +87,7 @@ If you run [WPML](https://wpml.org/) in **different domain per language** mode, 3. Its **Domain Name** is already filled in. Create a [plugin token](#connect-with-a-plugin-token) for that site, paste it into **Plugin Token** and click **Connect**. 4. Repeat for each language domain. -With **View stats in WordPress** enabled, the WordPress toolbar links to the dashboard that matches the language domain you're viewing. +With **View stats in WordPress** enabled, the WordPress toolbar includes a separate dashboard link for each configured language domain. ## The settings screen