plausible · metmarkosaric · Jun 10, 2026
diff --git a/docs/change-domain-name.md b/docs/change-domain-name.md
@@ -55,7 +55,7 @@ First and foremost, you'll need to make sure your stats are still tracking. Whet
   <tr>
     <td><b>WordPress plugin</b></td>
     <td>If your website is on WordPress, you're most likely using the plugin as that's the recommended installation method.</td>
-    <td>Update the site domain in your plugin settings</td>
+    <td>Update the site domain in your <a href="wordpress-integration#connect-with-a-plugin-token">plugin settings</a></td>
   </tr>
   <tr>
     <td><b>NPM package</b></td>

diff --git a/docs/custom-automatic-link-tracking.md b/docs/custom-automatic-link-tracking.md
@@ -18,10 +18,6 @@ Instructions below can be used to start tracking every `<a>` (i.e. link) element
 
 Here's how to automatically track clicks on cloaked affiliate links and other pretty URLs:
 
-:::tip Our WordPress plugin can track cloaked affiliate links automatically
-On WordPress? Check out our WordPress plugin which can track cloaked affiliate links automatically. [See more here](https://plausible.io/wordpress-analytics-plugin).
-:::
-
 ## 1. Add the JavaScript that will be sending the link click events to Plausible
 
 You need to add the following code to all of the pages where you want to track your links. You should insert the code below into your HTML page `<head>` section just under the custom event snippet.

diff --git a/docs/custom-event-goals.md b/docs/custom-event-goals.md
@@ -15,7 +15,7 @@ Custom events let you measure button clicks, subscription signups or any other a
 - **Using CSS class names**: add a class to any HTML element you want to track. No JavaScript required. This is the easiest approach for most use cases and is covered in the first section below.
 - **Using JavaScript**: call the `plausible()` function directly for more advanced tracking needs such as dynamic values, conditional logic or tracking non-click interactions. See the [manual JavaScript approach](#trigger-custom-events-manually-with-a-javascript-function) section.
 
-If you're using WordPress or Google Tag Manager, you can set up custom events with our [WordPress plugin](https://plausible.io/wordpress-analytics-plugin) or [GTM template](https://plausible.io/gtm-template) without writing code. Plausible also offers automated tracking for [outbound link clicks](outbound-link-click-tracking.md), [file downloads](file-downloads-tracking.md) and [form submissions](form-submissions-tracking.md) straight from your site settings, [pageview goals](pageview-goals.md) for tracking visits to specific pages and [404 error pages](error-pages-tracking-404.md) with a small snippet of code.
+If you're using WordPress or Google Tag Manager, you can set up custom events with our [WordPress plugin](wordpress-integration.md#track-custom-events-with-css-class-names) or [GTM template](https://plausible.io/gtm-template) without writing code. Plausible also offers automated tracking for [outbound link clicks](outbound-link-click-tracking.md), [file downloads](file-downloads-tracking.md) and [form submissions](form-submissions-tracking.md) straight from your site settings, [pageview goals](pageview-goals.md) for tracking visits to specific pages and [404 error pages](error-pages-tracking-404.md) with a small snippet of code.
 
 <CtaBox
   headline="Testing this workflow for your site? Custom events work during the free trial, no credit card required"

diff --git a/docs/custom-props/for-pageviews.md b/docs/custom-props/for-pageviews.md
@@ -5,10 +5,6 @@ description: "How to send custom properties with every pageview in Plausible by
 
 import useBaseUrl from '@docusaurus/useBaseUrl';
 
-:::tip Using WordPress?
-The quickest way to start tracking custom properties is to use our [official WordPress plugin](https://plausible.io/wordpress-analytics-plugin)
-:::
-
 ## Add your custom properties to your Plausible snippet
 
 You can add custom properties by updating your Plausible snippet.

diff --git a/docs/dashboard-faq.md b/docs/dashboard-faq.md
@@ -95,7 +95,7 @@ For a broader look at why numbers differ across analytics tools, see our [blog p
 
 If you've just installed Plausible and aren't seeing your own visits, there are a few common reasons:
 
-- **WordPress plugin**: Our [official WordPress plugin](https://plausible.io/wordpress-analytics-plugin) excludes logged-in admin visits by default. If the verification tool confirms the tracking is working, you have nothing to worry about.
+- **WordPress plugin**: Our [official WordPress plugin](wordpress-integration.md#exclude-admins-and-other-roles) excludes logged-in admin visits by default. If the verification tool confirms the tracking is working, you have nothing to worry about.
 - **Shields**: The [Shields feature](excluding.md) lets you block visits based on IP addresses, hostnames, countries or specific pages. Check whether you have any rules that might be excluding your own visits.
 - **Adblockers**: If you're using a browser extension or network-level adblocker, it may be blocking the Plausible script. Consider setting up a [proxy](proxy/introduction.md) to serve the script as a first-party connection.
 

diff --git a/docs/data-pipelines.md b/docs/data-pipelines.md
@@ -20,7 +20,7 @@ You can embed your Plausible stats dashboard into any other website using an HTM
 
 ### WordPress plugin
 
-By using our official WordPress plugin, you can view your Plausible stats dashboard directly in your WordPress dashboard without needing to visit our website. [Learn more here](https://plausible.io/wordpress-analytics-plugin).
+By using our official WordPress plugin, you can view your Plausible stats dashboard directly in your WordPress dashboard without needing to visit our website. [Learn more here](wordpress-integration.md#view-your-stats-inside-wordpress).
 
 ### Looker Studio
 

diff --git a/docs/ecommerce-revenue-tracking.md b/docs/ecommerce-revenue-tracking.md
@@ -110,13 +110,7 @@ For subscription upgrades, fire on the confirmation page after payment is proces
 
 ## Integrating with WooCommerce
 
-If you're running WooCommerce, you can use our [WordPress plugin](https://plausible.io/wordpress-analytics-plugin). It has built-in support for tracking of WooCommerce store activity including:
-
-* Tracking of several custom events including actions such as add to cart, complete purchase and revenue
-* Tracking of several custom properties including product name and product category
-* A purchase funnel tracking drop-off from viewing a product to completing a purchase
-
-All this is done automatically for you by our plugin and you don't need to manually set up any custom events nor make any changes to the code of your store. Check here to learn more about [WooCommerce site tracking with Plausible](https://plausible.io/blog/woocommerce-analytics-plugin).
+If you're running WooCommerce, our [WordPress plugin](wordpress-integration.md#track-ecommerce-revenue) tracks store activity automatically, including add to cart, completed purchases, revenue, product properties and a purchase funnel. You don't need to set up any custom events or change your store's code.
 
 ## Integrating with Shopify
 

diff --git a/docs/error-pages-tracking-404.md b/docs/error-pages-tracking-404.md
@@ -74,10 +74,6 @@ Add this code to your 404 page. For instance, if you're using WordPress, your 40
 
 You can place this code anywhere in the `<head>` or `<body>` section of your 404 page template.
 
-:::tip Using WordPress?
-The quickest way to start tracking 404 error pages is to use our [official WordPress plugin](https://plausible.io/wordpress-analytics-plugin)
-:::
-
 ## Step 2: Create a `404` goal on your site
 
 404 events won't show up in your dashboard automatically. You'll have to configure the goal for the conversion numbers to show up.

diff --git a/docs/excluding.md b/docs/excluding.md
@@ -11,7 +11,7 @@ Plausible automatically filters out bots, crawlers and referrer spam. You don't
 
 By default, Plausible Analytics tracks every visitor to your website. You might not want your office traffic to be counted. Or when you're working on your site, you might not want to record your own visits and page views.
 
-Here's how to block your internal traffic from your Plausible Analytics stats dashboard. You can block recording visitors from specific IP addresses, hostnames, countries or pages. If you're on WordPress, our [official WordPress plugin](https://plausible.io/wordpress-analytics-plugin) can exclude views from admins and other user roles without any manual configuration.
+Here's how to block your internal traffic from your Plausible Analytics stats dashboard. You can block recording visitors from specific IP addresses, hostnames, countries or pages. If you're on WordPress, our [official WordPress plugin](wordpress-integration.md#exclude-admins-and-other-roles) can exclude views from admins and other user roles without any manual configuration.
 
 ## Exclude visits by IP address
 

diff --git a/docs/file-downloads-tracking.md b/docs/file-downloads-tracking.md
@@ -34,10 +34,6 @@ After you enable file downloads tracking on your site, all the file downloads wi
 
 Heads up: File download tracking only works for clicks that happen on your tracked pages. If you share a direct link to a file in an email or elsewhere, those opens won't be counted. Visitors need to arrive at your site first and click the link from there.
 
-:::tip Using WordPress?
-The quickest way to start tracking file downloads is to use our [official WordPress plugin](https://plausible.io/wordpress-analytics-plugin)
-:::
-
 ## See all the file download clicks in your dashboard
 
 Click on **File Download** goal in the **Goals** tab of your Plausible dashboard to see the full list of all clicks on all files and have your dashboard filtered by file download clicks only. You can see:

diff --git a/docs/form-submissions-tracking.md b/docs/form-submissions-tracking.md
@@ -26,10 +26,6 @@ You can enable **Form submissions** as an optional measurement when adding a new
 
 After you enable form submissions tracking, we will automatically add a new goal called `Form: Submission` to your site.
 
-:::tip Using WordPress?
-The quickest way to start tracking form submissions is to use our [official WordPress plugin](https://plausible.io/wordpress-analytics-plugin)
-:::
-
 ## See all the form submissions in your dashboard
 
 Click on **Form: Submission** goal in the **Goals** tab of your Plausible dashboard to see the full list of all form submissions and have your dashboard filtered by them. You can see:

diff --git a/docs/outbound-link-click-tracking.md b/docs/outbound-link-click-tracking.md
@@ -32,10 +32,6 @@ By default, **Outbound links** is enabled when adding a new site to your Plausib
 
 After you enable outbound link click tracking, we will automatically add a new goal called `Outbound Link: Click` to your site.
 
-:::tip Using WordPress?
-The quickest way to start tracking outbound link clicks is to use our [official WordPress plugin](https://plausible.io/wordpress-analytics-plugin)
-:::
-
 ## See all the outbound link clicks in your dashboard
 
 Click on **Outbound Link: Click** goal in the **Goals** tab of your Plausible dashboard to see the full list of all clicks on all external links and have your dashboard filtered by external clicks only. You can see:

diff --git a/docs/plausible-script.md b/docs/plausible-script.md
@@ -33,7 +33,7 @@ You can add your main domain name as a site to your Plausible account and use th
 
 Installing Plausible on a site can be a slightly different process depending on what tools you're using to manage your site.
 
-- Are you using WordPress? We recommend you integrate Plausible by using our plugin. It's very lightweight, excludes your visits by default and allows you to see the stats directly in your WordPress dashboard. It also avoids conflicts with WP Rocket and similar plugins. [See more here](https://plausible.io/wordpress-analytics-plugin)
+- Are you using WordPress? Use our [official plugin](wordpress-integration.md) instead of adding the snippet manually. It excludes your own visits by default, lets you see the stats directly in your WordPress dashboard and avoids conflicts with WP Rocket and similar caching plugins.
 
 - Are you using Google Tag Manager? We have a guide on [how to integrate Plausible with our GTM template](https://plausible.io/gtm-template)
 

diff --git a/docs/proxy/guides/wordpress.md b/docs/proxy/guides/wordpress.md
@@ -6,4 +6,4 @@ description: "How to proxy Plausible Analytics on WordPress using the official p
 
 import useBaseUrl from '@docusaurus/useBaseUrl';
 
-You can use our official WordPress plugin to proxy your Plausible Analytics requests. It takes only a few minutes and requires no tech know-how or prior experience. Check full instructions and details on the other features of our [WordPress plugin here](https://plausible.io/wordpress-analytics-plugin).
+You can use our official WordPress plugin to proxy your Plausible Analytics requests. It takes only a few minutes and requires no tech know-how or prior experience. For setup, the other plugin features and troubleshooting, see [Adding Plausible to WordPress](../../wordpress-integration.md).
diff --git a/docs/troubleshoot-integration.md b/docs/troubleshoot-integration.md
@@ -187,6 +187,8 @@ Plausible is privacy-first and compliant with GDPR and ePrivacy regulations. You
 
 ## WordPress plugin issues
 
+These cover the most common plugin problems. For full setup and every plugin setting, see [Adding Plausible to WordPress](wordpress-integration.md).
+
 ### Admin visits are not showing
 
 Our WordPress plugin excludes logged-in administrator visits by default. This is intentional. If you want to track your own visits, go to the "Track analytics for user roles" section in the plugin settings and enable the Administrator role.
@@ -206,6 +208,14 @@ Skipping any step often leaves a stale script in place that the verification too
 
 The proxy creates a randomly named file in `/wp-content/uploads/`. When you migrate or clone your site, that file path may no longer match what the plugin expects. To fix this, disable the proxy, clear all caches, re-enable the proxy and clear all caches again. This forces the plugin to generate a fresh proxy file at the correct path.
 
+### Proxy script is slow
+
+The plugin notifies you if the proxy takes too long (over 500ms) to send pageviews. This usually means the speed module failed to install automatically. To install it manually:
+
+1. Access your server using (S)FTP, SSH or your host's file manager
+2. Go to the plugin directory, usually `wp-content/plugins/plausible-analytics`
+3. Open the `mu-plugin` directory inside it and copy `plausible-proxy-speed-module.php` to `wp-content/mu-plugins` (create the `mu-plugins` folder first if it doesn't exist)
+
 ### Plugin token showing as invalid
 
 Plugin tokens are site-specific. Make sure the token you are pasting was created for the exact domain you are trying to connect. Tokens always start with `plausible-plugin-`. If in doubt, create a new token in your Plausible site settings and connect it again.
Original file line number	Diff line number	Diff line change
Expand Up		@@ -6,4 +6,4 @@ description: "How to proxy Plausible Analytics on WordPress using the official p

		import useBaseUrl from '@docusaurus/useBaseUrl';

		You can use our official WordPress plugin to proxy your Plausible Analytics requests. It takes only a few minutes and requires no tech know-how or prior experience. Check full instructions and details on the other features of our [WordPress plugin here](https://plausible.io/wordpress-analytics-plugin).
		You can use our official WordPress plugin to proxy your Plausible Analytics requests. It takes only a few minutes and requires no tech know-how or prior experience. For setup, the other plugin features and troubleshooting, see [Adding Plausible to WordPress](../../wordpress-integration.md).