Installation

Rich Statistics requires WordPress 6.0 or higher and PHP 8.0 or higher. It works on single-site and multisite installations.

Option 1 — WordPress Plugin Directory

In your WordPress admin, go to Plugins → Add New.
Search for Rich Statistics.
Click Install Now, then Activate.

Option 2 — WP-CLI

wp plugin install rich-statistics --activate

For multisite, network-activate:

wp plugin install rich-statistics --activate-network

Option 3 — Manual upload

If your server cannot reach WordPress.org, you can install manually:

Download the latest free release ZIP from WordPress.org.
In WordPress admin, go to Plugins → Add New → Upload Plugin.
Upload the ZIP and activate.

The ZIPs published on GitHub Releases are build artifacts for developers and the files submitted to Freemius and WordPress.org. They are not intended as a separate user download channel.

System Requirements

Requirement	Minimum	Recommended
WordPress	6.0	Latest
PHP	8.0	8.2+
MySQL / MariaDB	MySQL 5.7 / MariaDB 10.3	MySQL 8.0+
Browser (admin)	Any modern browser	Chrome/Firefox/Edge latest

Database tables

On activation, the plugin creates four tables in your WordPress database (using $wpdb->prefix, e.g. wp_rsa_events on a standard install, or wp_2_rsa_events for subsite 2 on multisite):

Table	Purpose
`rsa_events`	One row per accepted pageview — page path, referrer domain, browser, OS, language, timezone, viewport, time on page
`rsa_sessions`	Session-level data — UTM parameters, entry page, session UUID (tab-scoped only)
`rsa_clicks`	Click coordinates for click maps (Premium)
`rsa_heatmap`	Scroll depth and hover data for heatmaps (Premium)

All tables are dropped cleanly on plugin uninstall if the Delete all data on uninstall option is checked in Data Settings.

Multisite notes

When network-activated, a network admin menu item appears under Network Admin → Analytics. A network administrator can disable tracking on any sub-site from that screen. Each sub-site's data is stored with its blog ID so network-wide and per-site reports are both available.

Upgrading to Premium

There is no separate premium ZIP to install. The upgrade happens as a standard WordPress plugin update:

In your WordPress admin, go to Analytics → Upgrade (added by the Freemius SDK).
Click Upgrade to Premium. You are taken to a Freemius-hosted checkout page.
Complete the purchase. Your license activates automatically on your site.
A standard WordPress update notification appears. Click Update Now.
Premium features are now active — no re-installation, no ZIP download.

License management: Go to Analytics → Account (the Freemius account menu) to view your license status, deactivate to move it to another site, or cancel. Each license covers one production site.

Freemius opt-in on first activation. The Freemius SDK makes outbound requests to api.freemius.com on first activation to power its opt-in screen and license verification. This is standard behavior for all Freemius-powered plugins. You can skip the opt-in — it does not affect plugin functionality.