Fix Saddle Analytics Problems
Find your symptom and apply the fix: no visits counted, a page that will not load, an empty Country card, missing AI bots and more.
Find your symptom below and apply the fix. If you are not sure what the symptom is, use the method at the end of this page.
No visits are counted
I visit my own site and nothing shows
Cause: the tracker is not loaded for signed-in administrators.
Fix: test in a private window while signed out. This is how it should work.
Nothing is counted, even in a private window
Work down this list.
- Clear your page cache. Pages cached before you installed do not load the tracker.
- Check the script is on the page. While signed out, view the page source and search for
tracker.js. If it is missing, your theme may not callwp_footer(). Switch to a default theme to confirm. - Check the request is sent. Open your browser’s developer tools, choose the Network tab, reload, and filter for
saddle-analytics. You should see a request ending in/hitwith status 204. - Check your browser. Visitors who send Do Not Track or Global Privacy Control are not counted. Try another browser.
The /hit request fails or is blocked
Cause: the tracker sends to your own site’s REST API at /wp-json/saddle-analytics/v1/. A security plugin or firewall that blocks the REST API for signed-out visitors blocks it too. So does an ad blocker in your test browser.
Fix: allow that address in the security plugin or firewall. Test without the ad blocker.
Some visitors are counted and some are not
Cause: this is normal. Ad blockers and privacy browsers stop the tracker for some people. Bots are left out on purpose. One address can send up to 120 tracking requests a minute, and more than that are ignored.
Fix: none needed. Use your numbers for trends.
Saddle shows “Tracking is off”
Cause: data from an older version is still moving into the new tables. Counting waits until the move is done.
Fix: keep wp-admin open. The move runs in the background while you use it.
The Analytics page will not load
I see a “Saddle Analytics” page with an install or update button
Cause: Saddle is not active, or it is older than 1.5.
Fix: click the button. Visits are still counted in the meantime.
“Your sign-in has expired. Sign in again to continue.”
Fix: click Sign in again.
“WordPress saw this request as signed out.”
Cause: if a reload does not fix it, a security or cache layer is removing the sign-in from the request.
Fix: click Reload. If it comes back, stop your cache or CDN from caching /wp-json/saddle-analytics/, and turn off security plugins one at a time to find the one that strips it.
“This account can’t view Analytics. Sign in as an administrator.”
Fix: sign in as an administrator. No lower role can view the reports.
“Couldn’t load this data.”
Fix: click Retry. If it keeps failing, open your browser console and look for errors, then test with other plugins turned off.
A report looks wrong
The Country card is empty
Cause: country comes from Cloudflare.
Fix: put your site behind Cloudflare, or accept an empty card. Saddle Analytics never looks up IP addresses.
AI (referred) shows zero
Cause: often you have had no AI visits in this range yet. Also, some AI apps open links without saying where the visitor came from, and those visits count as Direct.
Fix: pick a longer date range.
The AI crawlers card is empty
Cause: no known bot has visited in this range, or a full-page cache served the pages before WordPress ran.
Fix: click Details to see the bots being watched. Test the counter with the curl check in How to Test Saddle Analytics.
Returning visitors count as new
Cause: without cookies, a visitor is recognised for one day.
Fix: turn on Remember returning visitors if you need this. See Set Up Saddle Analytics.
The numbers look too low
Fix: look for a filter chip at the top of the page and remove it. Then check the date range.
The numbers do not match another stats tool
Cause: tools count visits, bots and blocked visitors in different ways.
Fix: none needed. Use each tool for trends.
Old page views are gone
Cause: page views are deleted after the number of days you chose, 90 by default. Visitor totals are kept.
Fix: raise Keep page views for (days) for the future. Deleted rows cannot be brought back.
Install problems
WordPress will not activate Saddle Analytics
Install and activate Saddle first. Saddle Analytics also needs WordPress 6.9 and PHP 8.1 or newer. See What Saddle Analytics Needs to Run.
Not sure what is wrong? Find the broken stage
Saddle Analytics does three jobs. Almost every problem lives in one of them.
- Tracking: the visitor’s browser tells your site a visit happened.
- Storage: your site writes that visit to the database.
- Reporting: the page reads it back.
Step 1: Is it reporting?
wp saddle-analytics status
- Rows exist, but the page is empty or wrong: the problem is reporting. Run
wp saddle-analytics summary --range=todayand compare it with the page for Today. If they match, check your filters and date range. If they differ, reload the page or try another browser. - Row counts are zero or not growing: go to Step 2.
- A table is missing: deactivate and activate Saddle Analytics to create it.
No command line? Compare the Dashboard box with the Analytics page. If the box sees visitors and the page looks wrong, it is a reporting problem.
Step 2: Is it storage?
wp saddle-analytics hit --page=/diagnostic
- It prints a visit and the row count goes up: storage works. The problem is tracking. Use the list under “Nothing is counted, even in a private window”.
- It fails or nothing is stored: the problem is storage. Check your host’s error log.
Step 3: Test for a plugin conflict
- Take a backup. Do this on a staging site if you can.
- Turn off every plugin except Saddle and Saddle Analytics.
- Test again. Still broken? It is not a conflict.
- If it is fixed, turn plugins back on one at a time and test after each.
Caching, security and speed plugins are the usual cause, because they change requests or delay scripts.
What to send when you ask for help
- Your Saddle, Saddle Analytics, WordPress and PHP versions.
- Whether your database is MySQL or SQLite.
- The output of
wp saddle-analytics status. - Which stage you narrowed it to, and what you saw.
- Any errors from the browser console or Network tab.
- Whether you use a CDN, a security plugin or a caching plugin.
Next steps
Fixed it? Confirm with How to Test Saddle Analytics. General questions are in the Saddle Analytics FAQ.