Skip to main content

How to check if Plausible is working

After you've added the Plausible script to your website, it's time to check if Plausible is working. There are various techniques for how you can do this. Here are the most popular:

Visit your site and look at the realtime report in Plausible

You can visit your website and your Plausible dashboard will update instantly with your visit. There are no delays in the data. The dashboard displays the data as soon as your visit is counted.

If you see your visit and the dashboard with graphs and numbers, it means everything is working! Congrats! Plausible Analytics is now tracking your website statistics while preserving the privacy of your visitors.

Ensure that the Plausible Analytics script is loading by checking realtime view

Do you keep seeing a blinking green dot screen? Is your visit not being counted? Read further for how you can verify if our script is installed correctly.

Ensure that the Plausible Analytics script is loading by checking the blinking dot

Check for the Plausible snippet in your source code

A simple way to verify if Plausible is working is to view the source code of your site and look for the Plausible snippet. Here's how:

  1. Visit your home page or any other page on your site.
  2. Use a keyboard shortcut to view the source code of your site. Press cmd+u on a Mac or ctrl+u on Linux and Windows. Alternatively, you can right-click anywhere on your page and click "View Page Source" (the wording may be slightly different depending on your web browser).
  3. Press cmd+f on a Mac or ctrl+f on Linux and Windows to search. Type data-domain to search for the Plausible snippet.
  4. Do you see our snippet? Ensure that the snippet is correct and that there are no unintended modifications compared to the snippet we provided you with?

If you see our snippet in your source code, it means Plausible is installed. If you see the snippet, you can try to open the realtime report in your Plausible dashboard and see if your visit was counted correctly.

Ensure that the Plausible Analytics script is loading by checking the source code

Check for the Plausible script in your browser's developer tools

You can also use your browser's developer tools to look for the Plausible script or any errors related to your Plausible integration.

  1. Visit your home page or any other page on your site.
  2. Open the developer tools by pressing the key F12 on Firefox or Chrome. Alternatively, you can right-click anywhere on your page and click "Inspect" (the wording may vary depending on your web browser).
  3. Look into the "Console" tab in the developer tools for any errors related to Plausible. If you see an error related to the Plausible script, it means that something's not right with your implementation. We have some troubleshooting options further down this article.
  4. Then click on the "Network" tab in the developer tools. It will be empty, so you would need to reload the page. After you refresh the browser, you will start seeing some data in the "Network" tab. You should see the script.js from Plausible in the list. The Plausible script should display status 200.
Ensure that the Plausible Analytics script is loading in the 'Network' tab

Is the Plausible script not installed on your site?

You should see the Plausible Analytics tracking script in the "Network" tab of developer tools or your website's source code. If you can't see the script, please double check if you've inserted it correctly. Installing Plausible on a site can be a slightly different process depending on what tools you're using.

We've put together several integration guides that cover popular website builders and content management systems (CMS) such as WordPress and Ghost. Thanks to the members of our community, there are also community integrations and plugins for several frameworks such as Hugo and GatsbyJS. These can help you set up and start counting your site visitors in no time.

Here's the full list of all integrations and guides.

How to troubleshoot your Plausible integration

  • Your browser's developer tools "Console" tab may give you some insights through the error code it provides. Make sure to check for any errors in the "Console" tab.

  • Please ensure that the script you use is exactly the same script as listed in your Plausible website settings. You can find your JavaScript snippet by logging into your Plausible account. Here you'll find the list of sites you've added to Plausible. Click on the "Settings" icon on the right-hand side of the domain name you'd like to get the snippet for. Then scroll down to the "JavaScript snippet" section on the following page.

  • Does your site use a Content Security Policy (CSP)? If it does, you need to add plausible.io specifically to the allowed domains. More info here.

  • Running on localhost? Our script automatically disables itself when running on localhost as most people don't want those stats to be counted. In the script.js script, window.location.hostname is used to verify that. If you do want to track stats on localhost, you can use our extension.

  • On WordPress and using WP Rocket, SiteGround Optimizer or other performance optimization plugins? These may affect our script. We recommend you use our official WordPress plugin to avoid these issues or to manually whitelist our script in the settings of the individual performance optimization plugin. Learn more abour our plugin here.

  • Using cache? Do purge the cache just in case.

  • Implemented Plausible using Google Tag Manager? GTM strips the data-* attributes by default which can break the tracking. Please follow our GTM guide for instructions on how to integrate Plausible using GTM.

  • Are you running an AMP page? To track Google AMP pages with Plausible, you need to declare an AMP-analytics object on your AMP pages. See the instructions here.

  • Are you running a browser extension that may be blocking our script? Do disable the extension or whitelist our script within the settings of the extension you are using

Would you like to exclude your own visits from being tracked?

You can follow the instructions in this guide.

On WordPress? Our WordPress plugin excludes admin visits by default.