Documentation Troubleshooting Step-by-Step Guide to Troubleshoot Tracker

Step-by-Step Guide to Troubleshoot Tracker

If you are experiencing issues with the tracker in WP Statistics, follow these steps to troubleshoot and resolve common problems.

1. Check the Response of the Request in XHR

  • Open your website and navigate to a single post in private browsing mode.
  • Use the Inspect tool to navigate to Network → XHR.
  • Refresh the page and click on the request to view the response.


  • Status: 200
  • Response: {"status":true}

Failed (Request is in Exclusion):

  • Status: 200
  • Response: {"status":false,"data":"user role"}

Check the data field in the response for the reason of the exclusion.

Failed (Invalid Signature):

  • Status: 403
  • Response: {"code":"rest_forbidden","message":"Invalid signature","data":{"status":403}} or {"status":false,"data":"Invalid signature"}

2. Check the IP Method Detection

Make sure the IP Detection Method in Settings → IP Detection is configured properly, you can refer to the IP Detection Settings documentation for more information.

3. Ensure WP REST API is Not Restricted

Make sure that wp-json is not restricted by any security plugin or server settings. If restricted, whitelist the endpoint wp-json/wp-statistics/v2 in the plugin settings.

4. Bypass Ad Blockers

Ad blockers may block the plugin’s REST API endpoint wp-json/wp-statistics/v2/hit. Enable the Bypass Ad Blockers option in the settings page to bypass this restriction. This can also resolve the issue mentioned in step 2.

5. Check the PHP Error Log

Examine the PHP error log on your server for any errors related to WP Statistics. This can provide insights into what might be causing the tracking issues.

6. Set the Tracking Method to Client-Side Tracking

Ensure that the Tracking Method in WP Statistics → Settings → Basic Tracking is set to Client-Side Tracking. This is recommended for better accuracy and future compatibility.

7. Clear the Cache

Clear your website’s cache, including any cache from cache plugins, server cache, or CDN cache, to ensure that the latest settings are applied.

8. Check for Plugin Conflicts

Deactivate other plugins one by one to check if there are any conflicts with WP Statistics. Sometimes, other plugins may interfere with the tracker.

9. Update WP Statistics

Ensure that you are using the latest version of WP Statistics. Updates often contain bug fixes and improvements that can resolve tracking issues.

10. Inspect JavaScript Errors

Use the browser console to check for any JavaScript errors that might be interfering with the tracking script. Address any errors that you find.

By following these steps, you can resolve common issues with the tracker in WP Statistics and ensure accurate data collection and display.