Plausible: Privacy-first web analytics plugin for WordPress

Plausible Analytics is an open source web analytics plugin for WordPress that is an easy to use, lightweight (< 1 KB) and privacy-friendly Google Analytics alternative.

Plausible Analytics WordPress plugin

  1. How is Plausible Analytics different from Google Analytics?
  2. What are the other features of Plausible Analytics for WordPress?
  3. How to get started with Plausible Analytics
  4. How to install Plausible Analytics WordPress plugin
  5. How to view your stats directly in your WordPress dashboard
  6. How to enable a proxy to get more accurate stats
    1. Stats not being recorded after enabling the proxy?
    2. If the proxy script is slow
  7. How to track external link clicks
  8. How to track file downloads
  9. How to setup custom events to track goal conversions
    1. Custom properties can be attached to events
  10. How to track 404 error pages
  11. How to enable hash-based URL tracking
  12. How to track visitors who use Internet Explorer
  13. How to exclude specific pages from being tracked
  14. How to exclude admins and other roles from being tracked
  15. Contribute to the development of our WordPress plugin

How is Plausible Analytics different from Google Analytics?

Plausible Analytics is built to be a more modern alternative to Google Analytics and other traditional analytics solutions. Here’s what makes us different:

  • Plausible, unlike Google Analytics, doesn’t use cookies, doesn’t use any long-term identifiers and doesn’t track any personal data. We’re exclusively powered by EU-owned cloud infrastructure. Read more on what makes Plausible a privacy-first web analytics

  • Plausible, unlike Google Analytics, is built for speed and performance. Our script is under 1 KB in size, which is 45 times more lightweight than the Google Analytics script. Plausible will not slow down your site

  • Plausible, unlike Google Analytics, is simple to use and get valuable insights from. All the key metrics are displayed on one page, including top content, top referral sources, external link clicks and goal conversions

  • Plausible like WordPress but unlike Google Analytics is open source software. You can inspect and review our source code to verify that our actions match with our words

  • Plausible, unlike Google Analytics, is not a free as in beer product. We don’t sell or share your site data to anyone. We choose the subscription business model rather than surveillance capitalism and are solely funded by the fees our subscribers pay us

  • There’s a 30-day free trial with no credit card required. If you find Plausible useful, you can get on a paid subscription. The plans start at $9/month or $7.5/month when billed annually and are based on the number of page views your sites have. You can see the pricing here

What are the other features of Plausible Analytics for WordPress?

  • Track clicks on external links so you can see which of your affiliate links are more popular than others
  • Track file downloads so you can see which of your documents are more popular than others
  • Setup goals and custom events using CSS class names so you can track conversions and analyze conversion attribution
  • Check your Plausible stats dashboard directly in your WordPress dashboard
  • Track 404 error pages that people visit so you can fix them and redirect them to more appropriate pages
  • Exclude specific pages from being tracked
  • Exclude admins from being tracked. You can exclude editors, authors and contributors from being tracked too
  • Allow specific user roles (editors, authors or contributors) to access the stats dashboard
  • See a link to the post stats in the toolbar while browsing your site

How to get started with Plausible Analytics

To use Plausible Analytics, you need to register an account. To explore the product, we offer you a free 30-day trial. No credit card is required to sign up.

Click here to register. It is a simple process and we only ask for your name and email address.

Register your Plausible account

After you verify your email address, you need to enter the domain name of the website you want to track.

Please, remove https and www from the URL, just keep the hostname (yourdomain.com). For example, if your site is https://www.yourdomain.com then the part to enter in the “Domain” field is yourdomain.com.

If you would like to track a subdomain such as blog.yourdomain.com then please include the subdomain. Plausible Analytics essentially sees different subdomains as different sites.

For example, if your subdomain is https://blog.yourdomain.com then the part to enter in the “Domain” field is blog.yourdomain.com.

Enter the domain name of the website you want to track

That’s it! You have now registered for an account and you have added your website. Now you need to go to your WordPress dashboard and activate the Plausible Analytics WordPress plugin.

How to install Plausible Analytics WordPress plugin

Here’s how you can install the Plausible Analytics plugin on your WordPress site:

  • Go into the “Plugins” section in the left-hand side navigation within your WordPress dashboard
  • Click on “Add New”
  • In the search box in the top right, type “Plausible Analytics” and press enter

Search and install the "Plausible Analytics" WordPress plugin

Activate our WordPress plugin

  • “Plausible Analytics” entry will now show up in the “Settings” section in the left-hand side navigation of your WordPress dashboard. Click on it to explore the various options available
  • Select the options and features that you want to enable and click on the “Save Changes” button
  • If you have a caching plugin activated, do purge the cache just in case

Plausible Analytics WordPress plugin settings

That’s it! You are now counting your site stats with a privacy-first web analytics tool. You can now go to our website and access your Plausible Analytics account to view the dashboard.

There are some optional features that you enable in the plugin settings. Here’s a look at those.

How to view your stats directly in your WordPress dashboard

You can view your Plausible stats dashboard directly in your WordPress dashboard without needing to visit our website.

To do so, you need to create a private shared link in your Plausible account first. The shared link is secure and impossible to guess. Here’s how to set it up:

Create a shared link in your Plausible account

  • In the “Visibility” area of your website settings in your Plausible account there’s a “Shared links” section where you can create your shared link. Click on the “+ new link” button to do so

  • Make sure to keep the password field blank as it’s not possible to view password-protected shared links within your WordPress dashboard

  • Click the “Create shared link” button and your new shared link will be displayed

  • Now go to your Plausible Analytics WordPress plugin settings. Paste your shared link in the “Shared Link” field in the “View your stats in your WordPress dashboard” section

  • Click on the “Save Changes” button to save it and to enable you to view your stats in your WordPress dashboard

  • You can now go to the “Dashboard” section in the left hand side of your WordPress admin navigation menu. Then click on “Analytics” to view your site statistics within your WordPress dashboard

  • The site statistics within your WordPress dashboard are available to the administrators by default. In the “Show the stats dashboard to specific user roles” section of our WordPress plugin, you can also grant access to the stats dashboard to editors, authors and contributors.

How to enable a proxy to get more accurate stats

Plausible script is not blocked to the same extent as Google Analytics but we’re blocked by some blocklist maintainers who have taken the stance that they want to block every tracking script and don’t want to have the responsibility to judge what’s good and what’s bad.

Site owners feel unfairly targeted and an innocent casualty of this arms race between blocklist maintainers and the adtech industry. Site owners want some data to figure out what’s going on and learn what they can do to improve. It’s unfortunate for them to lose valuable, privacy-friendly insights that help them create a better user experience.

We’ve introduced a proxy feature after hearing from so many site owners who expect privacy-first analytics not to be blocked. We wanted to give a choice to people that use Plausible Analytics.

  • Not concerned about missing data? Simply run our default script. A portion of your visitors will block it but otherwise it works all fine. In our testing, between 6% and 26% of people block scripts all depending on the type of the site and the audience. In more extreme cases, with very tech-savvy referral sources these numbers can get up to 60%

  • Are you concerned about missing data? Proxy our script. We’ve made it easy to do so in our WordPress plugin.

  • In the “Bypass adblockers” section of our WordPress plugin settings, tick the “Enable proxy” and click on the “Save Changes” button

Enable proxy in our WordPress plugin

  • If you have a caching plugin enabled, please make sure to clear the cache for the changes to take effect

  • Enabling the proxy will make our script run as a first-party connection from your domain name. The proxy uses WordPress’ API with a randomly generated endpoint, starting with yourdomain.com/wp-json and it creates a randomly named folder and file in the /wp-content/uploads/ directory

Stats not being recorded after enabling the proxy?

We’ve put a lot of effort to ensure that the proxy works smoothly and have taken measures to prevent conflicts with popular performance optimization and caching plugins such as the WP Rocket, SG Optimizer, WP Optimize and LiteSpeed Cache. However, sometimes things might not go as planned.

In case plugin conflicts arise with your WordPress, it might cause the stats not to be recorded properly. So please give your integration a quick double-check after you enable the proxy to make sure the stats are being recorded. And if you notice anything weird, don’t hesitate to reach out to us. We’re here to help!

If the proxy script is slow

We will send you a notification if the proxy takes too long (>500ms) to send pageviews. This probably means the speed module failed to install automatically. To resolve this:

  • Access your server using (S)FTP, SSH or your host
  • Navigate to the directory of the Plausible plugin, usually wp-content/plugins/plausible-analytics
  • Open the mu-plugin directory within the plugin directory and copy the plausible-proxy-speed-module.php file to the wp-content/mu-plugins folder (if the mu-plugins folder doesn’t exist within wp-content, create it before copying the file)

Outbound links play a significant role on the open web and Plausible Analytics plugin can help you automate external link click tracking on your WordPress site.

In the “Enhanced measurements” section of our WordPress plugin settings, tick the “Outbound links” and click on the “Save Changes” button.

Outbound link clicks won’t show up automatically in your Plausible dashboard. You’ll have to configure the goal for them to show up. Here’s how:

  • To configure a goal, go to your website’s settings in your Plausible Analytics account and visit the “Goals” section
  • You should see a prompt to add a goal. Click on the “+ Add goal” button to go to the goal creation form

Visit the "Goals" section in your Plausible account

  • Select Custom event as the goal trigger and enter this exact name: Outbound Link: Click

Select Custom event and create a goal

  • Next, click on the “Add goal” button and you’ll be taken back to the Goals page

After you’ve completed this process, all the external link clicks will start being tracked and will be displayed in the “Goal Conversions” report of your Plausible Analytics dashboard.

You’ll see “Outbound Link: Click” goal as soon as the first external link click has been tracked.

How to track file downloads

File downloads tracking is essential for many site owners and Plausible helps you automate this process. Our file downloads tracking captures a file download event each time a link is clicked with a document, presentation, text file, compressed file, video, audio or other common file type.

Both internal and external files downloads are tracked. These file extensions are tracked:

.pdf, .xlsx, .docx, .txt, .rtf, .csv, .exe, .key, .pps, .ppt, .pptx, .7z, .pkg, .rar, .gz, .zip, .avi, .mov, .mp4, .mpeg, .wmv, .midi, .mp3, .wav, .wma

In the “Enhanced measurements” section of our WordPress plugin settings, tick the “File downloads” and click on the “Save Changes” button.

File downloads won’t show up automatically in your Plausible dashboard. You’ll have to configure the goal for them to show up. Here’s how:

  • To configure a goal, go to your website’s settings in your Plausible Analytics account and visit the “Goals” section
  • You should see a prompt to add a goal. Click on the “+ Add goal” button to go to the goal creation form
  • Select Custom event as the goal trigger and enter this exact name: File Download
  • Next, click on the “Add goal” button and you’ll be taken back to the Goals page

After you’ve completed this process, all the file downloads will start being tracked and will be displayed in the “Goal Conversions” report of your Plausible Analytics dashboard.

You’ll see “File Download” goal as soon as the first link that leads to a file has been recorded.

How to setup custom events to track goal conversions

Plausible Analytics plugin makes it easy to set up custom events and track actions such as purchases, signups, button clicks or form submissions.

In the “Enhanced measurements” section of our WordPress plugin settings, tick the “Custom events” and click on the “Save Changes” button.

Now you need to tag the site elements you want to track. No JavaScript knowledge is required to do this. The only thing you need is to tag the site element you want to track with a CSS class name directly in your WordPress editor. Here’s how:

  • You can click on any block element you want to track such as a button or a form. This will open up the block menu on the right-hand side of your screen

Click on any block element you want to track

  • You can then click on “Advanced” and add a CSS class name in the “Additional CSS class(es)” field. Add the CSS class name in this format: plausible-event-name=MyEventName. For instance, if you want to track form submissions on your contact form, you could use: plausible-event-name=Form+Submit

Add a CSS class name in the "Additional CSS class(es)" field

Custom events won’t show up automatically in your Plausible dashboard. You’ll have to configure the goal for them to show up. Here’s how:

  • To configure a goal, go to your website’s settings in your Plausible Analytics account and visit the “Goals” section
  • You should see a prompt to add a goal. Click on the “+ Add goal” button to go to the goal creation form
  • Select Custom event as the goal trigger and enter the name of the custom event you are triggering. The name must match the one you added as a CSS class name on your site for conversions to appear in your analytics dashboard
  • In our example where you added a CSS class name plausible-event-name=Form+Submit, the goal to add to your Plausible account is Form Submit (plus is replaced by a space)
  • Next, click on the “Add goal” button and you’ll be taken back to the Goals page

When you navigate back to your Plausible dashboard, you should see the number of visitors who triggered the custom event. Custom events are listed at the bottom of your dashboard in the “Goal Conversions” section. Your custom event will appear there as soon as the first conversion has been recorded.

Custom properties can be attached to events

Custom properties can be attached to events to capture dynamic elements and to further break down goal conversions. Let’s say you have a contact form both in the header and footer of your site.

In addition to tracking submissions, you might want to know which section of your site the form was submitted on. Instead of creating separate goals for each form, you can send a custom property instead:

plausible-event-<property>=<value> allows you to define custom properties that are sent with your custom event. For example plausible-event-position=footer. The full CSS class name would look like this:

plausible-event-name=Form+Submit plausible-event-position=footer

You can add as many of these classes as you want. And the names can be anything that you want. Custom properties will show up automatically on your dashboard as long as you’ve added the goal itself. You don’t need to manually add them in your settings.

For more details on custom events and custom properties, please check out this documentation page.

How to track 404 error pages

Having 404 error pages on your WordPress site can lead to a bad user experience, a negative first impression, and even damage your search engine rankings and traffic you get from Google.

Plausible Analytics plugin can help you identify those broken links and 404 page not found errors. You do not need to enable this feature in the WordPress plugin settings. It is enabled by default.

404 error pages won’t show up automatically in your Plausible dashboard though. You’ll have to configure the goal for them to show up. Here’s how:

  • To configure a goal, go to your website’s settings in your Plausible Analytics account and visit the “Goals” section. You should see a prompt to add a goal
  • Click on the “+ Add goal” button to go to the goal creation form
  • Select Custom event as the goal trigger and enter this exact name: 404

Select Custom event and create a 404 goal

  • Next, click on the “Add goal” button and you’ll be taken back to the Goals page

After you’ve completed this process, all the 404 error pages will start being tracked and will be displayed in the “Goal Conversions” report of your Plausible Analytics dashboard.

You’ll see “404” goal as soon as the first visit on an error page has been tracked.

How to enable hash-based URL tracking

Does your site contain hash-based URLs such as yourdomain.com/blog-post#specific-subheading or yourdomain.com/#contact?

Normally the hash part of the URL is discarded in your Plausible dashboard. You can enable “Hash-based routing” in your Plausible WordPress plugin settings to preserve the hash-based routing in your stats and see the different pages your visitors have viewed.

In the “Enhanced measurements” section of the Plausible WordPress plugin settings, tick “Hash-based routing” and then click on the “Save Changes” button.

How to track visitors who use Internet Explorer

The default Plausible script won’t work on Internet Explorer because it uses the document.currentScript API to read configuration options.

In the “Enhanced measurements” section of our WordPress plugin settings, you can enable the “IE compatibility” mode to count visitors who use the Internet Explorer browser.

How to exclude specific pages from being tracked

In the “Exclude specific pages from being tracked” section of our WordPress plugin settings, you can add a list of page paths that you don’t want to be counted in your website analytics.

Any pages you list should be comma-separated. All entries must begin with a /, and should not include the trailing slash as we account for this automatically.

You can also use asterisks to indicate unspecified regions of the pathname:

  • Asterisks (*) expand to any stretch (of length >=0) of the page path and can be on either end or in the middle of any entry, but can’t be in the place of slashes.
  • Double asterisks (**) expand to any stretch (of length >=0) of the page path, can be on either end or in the middle of any entry, and can represent any characters, even slashes.

Here are some common use cases and examples for how to exclude pages:

exclusion rule pages that will match
/blog4 /blog4 and exactly /blog4 with nothing before or after it, so not /blog45 nor /blog4/new nor /blog
/rule/* /rule/<anything>, with <anything> being any set of characters (length >=0), but not a forward slash - for example, both /rule/1 as well as /rule/general-rule-14, but not /rule/4/details nor /rules
/how-to-* /how-to-<anything> - for example, /how-to-play or /how-to-succeed, but not how-to-/blog
/*/admin /<anything>/admin - for example, /sites/admin, but not /sites/admin/page-2 nor /sites/2/admin nor /admin
/*/priv/* /<anything>/priv/<anything> - for example, /admin/priv/sites, but not /priv nor /priv/page nor /admin/priv
/rule/*/* /rule/<anything>/<anything> - for example, /rule/4/new/ or /rule/10/edit, but not /rule nor /rule/10/new/save
/wp/** /wp<anything, even slashes> - for example, /wp/assets/subdirectory/another/image.png or /wp/admin, and everything in between, but not /page/wp

How to exclude admins and other roles from being tracked

By default, our WordPress plugin excludes your own “administrator” visits from being counted in the stats. You can optionally choose to exclude visits from being counted for other user roles too including authors, editors and contributors. Go to the “Track analytics for user roles” section of our WordPress plugin to do so.

If you’d like to count your visits, you can do so as well. Simply tick off the user role that you prefer to track and click on the “Save Changes” button.

Contribute to the development of our WordPress plugin

You can contribute to our WordPress plugin too. Add your feature requests, upvote existing request or even contribute with your code. Here’s our main GitHub repo and our WordPress plugin repo.

Enjoying Plausible Analytics and our WordPress plugin? Most of our subscribers come from word of mouth, so if you love Plausible, we’d appreciate if you’d consider leaving a comment in the official WordPress plugin directory. Thank you!

Ready to dive in?
Start your free trial today.

Cloudflare Web Analytics vs Plausible Analytics

Cloudflare Web Analytics is a new player on the simple, privacy-first and de-Googled web analytics market.

Plausible: GDPR, CCPA and cookie law compliant site analytics

Even though the purpose of Plausible Analytics is to track the usage of a website, this can still be done without collecting any personal data or personally identifiable information (PII), without using cookies and while respecting the privacy of the website visitors.

What makes Plausible a great Google Analytics alternative

Many site owners have the habit of installing the Google Analytics tracking script on their sites as one of the first actions they take after the launch.

How to offer a white label web analytics dashboard powered by Plausible

We’ve made it easy for you to provide or resell a white label version of our simple and privacy-centric web analytics dashboard to your customers. We’ve built several features to make it easy to integrate web analytics powered by Plausible (but without our branding) directly into your user interface.

Plausible: Lightweight web analytics tool (<1KB) that doesn't slow down your site

Plausible Analytics script weighs less than 1 KB. That’s 45 times smaller than the Google Analytics Global Site Tag. Plausible will reduce your page weight and will stop your site from loading slow.

Plausible: Open source Google Analytics alternative

Plausible Analytics is an open source, simple, lightweight and privacy-friendly Google Analytics alternative. One aspect that makes Plausible different from many of the other web analytics tools such as Google Analytics is the fact that Plausible is open source software. Let’s take a look at what that means exactly.

Plausible: Privacy focused Google Analytics alternative

Even though the purpose of Plausible Analytics is to track the usage of a website, this can still be done without collecting any personal data or personally identifiable information (PII), without using cookies and while respecting the privacy of your website visitors.

Plausible: Self-Hosted Google Analytics alternative

Plausible Analytics is an open source web analytics tool. Our mission is to reduce corporate surveillance by making a useful and privacy-friendly website analytics tool that doesn’t come from the adtech world.

Easy to use, actionable and privacy-compliant analytics for ecommerce and startups

Plausible Analytics helps ecommerce and SaaS startups get some actionable data to make better decisions. At the same time, their visitors keep having a privacy-friendly and enjoyable experience.

Plausible: Simple web analytics tool you can use to measure site traffic

The goal of Plausible Analytics is to provide you all the valuable and actionable website traffic metrics at a glance in a simple and modern web analytics dashboard.

What makes Plausible a great Matomo alternative

Matomo, formerly known as Piwik, was founded in 2007 and has long been the most well known open source alternative to Google Analytics. Matomo is installed on 1.9% of all websites and this is an amazing success for a great open source web analytics project.

We've collected $78,000 in the two years of our donation fund

We’ve managed to collect $78,000 over the two years of this initiative and have made donations to different projects including the Red Cross, the Erlang Ecosystem Foundation, the Sea Shepherd, the Ocean Cleanup and the Mossy Earth.

Website analytics platform for bloggers and content creators

Many people create content on their personal websites and blogs. There are many motivations behind this. Some use it like a diary, some as a hobby, or as a way to connect to other people, as a way to build an audience, make money and even improve their career opportunities.

Website analytics platform for freelancers and agencies

One of the use cases Plausible Analytics was specifically designed for are the freelancers and agencies who work with clients developing their websites, communication and marketing practices.