Configuration
All settings live under Analytics → Data Settings in your WordPress admin. No wp-config.php edits are needed.
Data Retention
Controls how long raw pageview and heatmap rows are kept in the database. Older rows are pruned automatically by a daily WP-Cron job.
| Option value | Behavior |
|---|---|
30 | Keep the last 30 days |
90 | Keep the last 90 days (default) |
180 | Keep the last 6 months |
365 | Keep the last year |
0 | Keep forever (pruning disabled) |
You can also trigger pruning immediately from the WP-CLI: wp rsa prune.
Bot Score Threshold
Requests with a bot score equal to or above this value are silently discarded and not recorded. The score range is 0–10.
| Threshold | Effect |
|---|---|
3 (default) | Balanced — catches most bots with minimal false positives |
2 | More aggressive — may catch headless browsers that try to mimic real users |
5 | Lenient — only filters obvious bots; use when you notice legitimate traffic being blocked |
10 | Only filters self-announced crawlers (Googlebot, etc.) |
Excluded roles
By default, visits from logged-in users with the manage_options capability (admins) are not tracked. You can extend exclusions to editors, authors, or any role via the Excluded Roles checkbox list in Data Settings.
Network-level disable
On multisite, a network administrator can disable tracking for any sub-site from Network Admin → Analytics → Sites. This sets a network option that the tracker respects before any JavaScript is enqueued — no data is collected from disabled sites.
Available wp_options keys
| Option key | Type | Default | Description |
|---|---|---|---|
rsa_retention_days | int | 90 | Days to keep data (0 = forever) |
rsa_bot_score_threshold | int | 3 | Minimum bot score to reject |
rsa_excluded_roles | array | ['administrator'] | Roles whose visits are not tracked |
rsa_email_report_enabled | bool | false | Enable scheduled email reports (Premium) |
rsa_email_report_frequency | string | 'weekly' | weekly or monthly |
rsa_email_report_recipient | string | admin email | Recipient address for reports |
rsa_delete_on_uninstall | bool | false | Drop tables and options on uninstall |