What Saddle Analytics Needs to Run
Saddle Analytics needs WordPress 6.9, PHP 8.1 and the free Saddle plugin. Check the full list and the hosting notes before you install.
Saddle Analytics runs on ordinary WordPress hosting. There is no account to create and no outside service to sign up for.
What you need
- WordPress 6.9 or newer
- PHP 8.1 or newer
- Saddle 1.5 or newer. Saddle is free. The reports open inside it.
- MySQL or SQLite. Both are supported.
You can check your PHP version under Tools → Site Health → Info → Server.
Why does it need Saddle?
Saddle Analytics is a page inside Saddle, at Saddle → Analytics. WordPress asks you to install Saddle first.
If Saddle is ever turned off, visits are still counted. Saddle Analytics then shows a page that says “Visits are still counted. The reports open inside Saddle.” and a button to get Saddle back.
What it adds to your database
Saddle Analytics creates three tables:
- Visitors: one row per visitor, with their first and last source, country, browser, operating system, device and totals.
- Page views: one row per page view or exit link click. Old rows are deleted after 90 days by default.
- Crawlers: one row per bot per day. These are deleted on the same schedule.
You choose how long page views are kept, from 7 days to 3 years. See Saddle Analytics Settings. Visitor rows stay until you delete the plugin’s data.
Hosting notes
- Page caching works for visitor counts. The tracker runs in the visitor’s browser, so cached pages are still counted. Clear your page cache once after you install, so your pages load the tracker.
- Page caching hides some AI bots. Bots are counted when WordPress serves the page. A page served straight from a full-page cache never reaches WordPress, so that bot visit is not counted.
- Country needs Cloudflare. Country comes from Cloudflare’s
CF-IPCountryheader. If your site is not behind Cloudflare, the Country card stays empty. Saddle Analytics never looks up IP addresses. - Scheduled tasks must run. A daily task deletes old page views and changes the daily secret used to count visitors without cookies.
What it does not need
- No licence key.
- No account with an outside stats service.
- No tracking code pasted into your theme.
- No scripts, fonts or images loaded from other servers.
Common problems
WordPress says a required plugin is missing
Install and activate Saddle first, then activate Saddle Analytics.
The page says “The reports need Saddle 1.5 or newer”
Your copy of Saddle is too old to show the reports. Click Update Saddle. Visits are still counted while you update.
My host runs an older PHP
Most hosting control panels let you change the PHP version. Look for “PHP version” or ask your host to move you to PHP 8.1 or newer.
Next steps
If your site meets the list above, install Saddle Analytics. New here? Start with What Is Saddle Analytics?