Premium Features
All premium features are unlocked by a Premium license managed through Freemius. The plugin is the same codebase — premium features are enabled by your license key.
Click Heatmaps
Click coordinates are recorded every time a visitor clicks or taps anywhere on the page. The heatmap overlay is rendered on top of a live screenshot of your page using the CSS pointer-events: none overlay technique — no external screenshot service required.
What is stored
- Page path
- Click x position as a percentage of page width
- Click y position as a percentage of page height
- Element tag and any stable semantic ID (e.g.
button#add-to-cart) - Timestamp (date only — no time-of-day to avoid session reconstruction)
What is NOT stored
- Session ID — clicks are not linkable to a specific visit
- User ID — clicks are not linkable to a logged-in user
- Absolute pixel coordinates — only percentage positions
Click Tracking & Destination Capture
Non-navigational link clicks are tracked by protocol: tel:, mailto:, geo:, sms:, and file downloads. HTTP/HTTPS navigation is tracked automatically as pageviews and is not double-counted here.
The Destination column in the Click Map records the actual value passed to the protocol handler:
| Protocol | Destination stored | Example |
|---|---|---|
tel: | Phone number | +15551234567 |
mailto: | Email address | hello@example.com |
sms: | SMS number | +15551234567 |
geo: | Coordinates | 37.786,-122.4 |
| download | File path or URL | /files/brochure.pdf |
You can also configure additional element IDs and CSS classes to track in Analytics → Preferences.
Scroll Heatmaps
The maximum scroll depth for each page session is recorded as a percentage. The scroll heatmap visualises the distribution of how far visitors scroll on each page.
- Value stored:
(page, scroll_pct, date) - No session ID stored — cannot reconstruct an individual visitor's scroll behavior
Email Reports
Config lives in Analytics → Data Settings → Email Reports.
| Setting | Options | Default |
|---|---|---|
| Enabled | On / Off | Off |
| Frequency | Weekly (Mondays) / Monthly (1st) | Weekly |
| Recipient | Any email address | Admin email |
Reports include: period-over-period comparison, top 10 pages, top 5 referrers, and summary stats (pageviews, sessions, bounce rate, avg time on page). Reports are sent via wp_mail() — no third-party email service.
PWA Dashboard
The analytics dashboard can be installed as a Progressive Web App on any device. This makes it available in your device's app launcher for quick access to live stats without opening a browser and navigating to WordPress admin.
- Works on Chrome (desktop + Android) and Safari (iOS 16.4+)
- Updates in real time via the REST API
- Works offline: shows the most recently loaded data
- Install prompt appears at the bottom of the Analytics dashboard when the browser supports it
How upgrading works
There is no separate premium ZIP to download or reinstall. The upgrade is a standard WordPress plugin update delivered through Freemius:
- In your WordPress admin, navigate to Analytics → Upgrade.
- Click Upgrade to Premium. You are taken to a Freemius-hosted payment page.
- Complete the purchase. Freemius activates your license silently on your site in the background.
- WordPress shows a normal Update Available notification for Rich Statistics. Click Update Now.
- Premium features are immediately active. No re-installation, no ZIP file.
Moving your license
Each license covers one production site. To move it:
- On the original site, go to Analytics → Account and click Deactivate License.
- On the new site (with the free version installed), go to Analytics → Account and click Activate License.