← Haych/dev Heatmaps

Haychdev Heatmaps — Support & Docs

A short guide to installing and using Haychdev Heatmaps. Everything here applies to the free plugin; Pro additions are called out at the end.

Getting started

  1. Install Haychdev Heatmaps from your WordPress dashboard (Plugins → Add New → search "Haychdev Heatmaps"), or download it from WordPress.org.
  2. Activate it. Tracking starts automatically — there's no tag to paste and no account to create.
  3. Visit a few pages on the front end so there's data to look at.

Viewing a heatmap

Open any page of your site while logged in and use the floating toolbar to overlay the heatmap on the live, responsive layout:

  • Clicks — where visitors clicked, as a heat overlay.
  • Scroll — how far down the page visitors reached.
  • Hover over any heated area to read its exact click count and share of the page (or scroll-depth reach in scroll mode).
  • Switch device — desktop, tablet, and mobile views are tracked separately.

The admin screen

Under the Haychdev menu you'll find the per-page traffic table, tracking settings, and a one-click data reset. Use it to see which pages have data and to manage what's collected.

Privacy & cookies

  • Heatmap data is stored in your own WordPress database — nothing is sent to third-party servers.
  • The tracker sets no cookies, stores no IP addresses, and collects no personal data or fingerprints.
  • Because of that, the plugin is consent-banner-friendly by design. (Consult your own counsel for your jurisdiction.)

Performance

The tracker is a single vanilla-JS file under 4 KB, loaded deferred, sending one request per pageview. On busy pages, hits are sampled automatically so tracking never becomes a load problem.

Data & retention

  • Everything lives in three custom tables in your database. Deleting the plugin removes them completely.
  • Data is kept 90 days by default. Change it with the hd_heatmaps_retention_days filter:
add_filter( 'hd_heatmaps_retention_days', fn() => 180 );
  • Export click data as CSV from the admin screen.

Pro features

A Haychdev Heatmaps Pro license adds extended data retention beyond 90 days, scheduled weekly email reports, segmentation by logged-in role / referrer / UTM campaign, and funnels (conversion-path analysis). See the plugin page to upgrade.

Troubleshooting

  • Heatmap looks empty — it needs real front-end traffic first; click around your site (logged out, or in a private window) to generate data.
  • Overlay won't open — make sure you're viewing the front end while logged in with an account that can manage options.
  • No data being recorded — a caching or "optimize JavaScript" plugin may be deferring or stripping the tracker; exclude the Haychdev Heatmaps script from JS minification/combination.

Getting help

Check this page first. For anything else, use the plugin's WordPress.org support forum or reach out through the support channel on haychdev.com.