{"id":3697,"date":"2026-11-10T09:00:35","date_gmt":"2026-11-10T01:00:35","guid":{"rendered":"https:\/\/www.hitsteps.com\/blog\/add-session-recording-and-heatmaps-to-wordpress\/"},"modified":"2026-11-10T09:00:35","modified_gmt":"2026-11-10T01:00:35","slug":"add-session-recording-and-heatmaps-to-wordpress","status":"publish","type":"post","link":"https:\/\/www.hitsteps.com\/blog\/add-session-recording-and-heatmaps-to-wordpress\/","title":{"rendered":"How to add session recording and heatmaps to WordPress (step by step)"},"content":{"rendered":"<p>A traffic chart tells you a page got visits, not why a visitor left without checking out or skipped your form. Heatmaps and session recordings fill that gap.<\/p>\n<p>Heatmaps show where people click on a page. Session recordings replay how a visit actually played out. Both work on WordPress with the free Hitsteps plugin, and this guide covers the whole setup from a fresh site to your first reports.<\/p>\n<h2>What you need before starting<\/h2>\n<ul>\n<li>A self-hosted WordPress site, or a WordPress.com plan that allows custom code<\/li>\n<li>Administrator access to WordPress<\/li>\n<li>A Hitsteps account and the API key for the site you want to measure, copied from Settings &gt; Tracking Code in the Hitsteps dashboard<\/li>\n<\/ul>\n<h2>Step 1: Install the free plugin<\/h2>\n<p>Log in to WordPress, open Plugins &gt; Add New, and search for Hitsteps. Install the Hitsteps visitor manager plugin and activate it. You can also grab it directly from the <a href=\"https:\/\/wordpress.org\/plugins\/hitsteps-visitor-manager\/\">WordPress.org listing<\/a>.<\/p>\n<h2>Step 2: Connect your site<\/h2>\n<p>Open Settings &gt; Hitsteps in the WordPress admin and connect in one of two ways:<\/p>\n<ul>\n<li>New to Hitsteps: choose Create account and connect and register from the plugin.<\/li>\n<li>Already have an account: paste the website API key into the Connect with an API key field and save. Each site has its own key, copied from Settings &gt; Tracking Code for that site. The Existing account tab logs in with your Hitsteps email and password instead, if you prefer.<\/li>\n<\/ul>\n<p>The plugin adds the tracking code to your public pages without a theme edit. Clear your page, optimizer and CDN cache once so a cached homepage does not serve the old page, then open your site in a private window and check the Hitsteps live dashboard for your own visit.<\/p>\n<p>Keep one Hitsteps installation per site: a manual snippet or a Google Tag Manager tag that also points at Hitsteps double counts visits. Other analytics services alongside Hitsteps are fine.<\/p>\n<h2>Step 3: Turn on click heatmaps<\/h2>\n<p>In Settings &gt; Hitsteps, open Advanced settings and keep Heatmaps and Page Analysis set to On. It is on by default and counts clicks so Hitsteps can build the heatmap reports. Heatmaps are part of Growth plans and above and the 7-day Pro trial for new accounts; the Free and Starter plans do not include them.<\/p>\n<p>Once visitors click on your public pages, open Heatmap or Page Analysis in the dashboard. Start with a page that already gets visits, like your homepage or a product page.<\/p>\n<h2>Step 4: Turn on session recording<\/h2>\n<p>Recording is separate from tracking, so installing the plugin does not start it by itself. Get the privacy side ready first: open Experience &gt; Settings and review how consent and script loading are handled, whether text rendering is masked in the Privacy and masking settings, and which page paths are recorded or excluded in Pages and interactions. Masking happens in the browser before anything is sent; passwords and payment fields always stay masked. Test with fictional values on your own page, and keep your site&#8217;s notice in line with what is configured. The <a href=\"https:\/\/www.hitsteps.com\/guide\/privacy-and-data-controls\/\">privacy and data controls guide<\/a> explains each control.<\/p>\n<p>Then open Experience &gt; Recordings &gt; Settings and switch Record visitor sessions to Enabled, then save. The option appears when your account can use Experience, which is included with Pro and higher plans and the free Pro trial for new accounts; Experience opens to sites gradually, and its menu shows what your site and account can use. Changing recording settings requires the website owner, or a teammate with manage rights. Turning the switch on does not obtain consent and does not erase recordings already stored; the <a href=\"https:\/\/www.hitsteps.com\/guide\/session-recordings\/\">session recording guide<\/a> covers retention, sharing and deletion.<\/p>\n<h2>Step 5: Look at what happened<\/h2>\n<p>Heatmaps build from real clicks, so a page with steady traffic shows a useful pattern sooner, while a quiet page needs more visits and takes longer. For recordings, open the Recordings list and replay a visit that matters, like the one that reached your checkout or pricing page but left.<\/p>\n<p>Keep it simple: pick one page, read its heatmap, replay the visits on it, change one thing and compare. The <a href=\"https:\/\/www.hitsteps.com\/blog\/why-visitors-leave-session-recording-workflow\/\">workflow article on why visitors leave<\/a> shows how to turn one recording into a fix.<\/p>\n<h2>What these reports cannot tell you<\/h2>\n<ul>\n<li>A click heatmap shows where people clicked, not whether the click finished the job. Verify a sale or form submission in your store or form tool before calling something fixed.<\/li>\n<li>Recordings are samples of your daily visits, so a quiet page may have few or none.<\/li>\n<li>Recording labels can include IP-derived or organization names, and readable text is masked according to the site&#8217;s privacy settings. Masking is a control, not a promise of zero personal data.<\/li>\n<\/ul>\n<h2>FAQ<\/h2>\n<p><strong>Do heatmaps and recordings start automatically after install?<\/strong><br \/>\nNo. Tracking starts once you connect. Click heatmaps also need Heatmaps and Page Analysis in Advanced settings and a plan that includes them, and session recording needs the Record visitor sessions switch enabled in Experience.<\/p>\n<p><strong>Who can turn recording on or change privacy settings?<\/strong><br \/>\nThe website owner, or a teammate the owner granted manage rights to. Other members can view content read-only.<\/p>\n<h2>Your next step<\/h2>\n<p>One free plugin, one API key, then two switches for the behavior reports. Install the free Hitsteps plugin from WordPress.org, connect your site, and check the live dashboard for your own visit. The first heatmaps and recordings follow as your visitors come back.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Add session recordings and click heatmaps to your WordPress site with the free Hitsteps plugin. Install, connect, and watch the first real visits.<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3],"tags":[],"class_list":["post-3697","post","type-post","status-publish","format-standard","hentry","category-news"],"_links":{"self":[{"href":"https:\/\/www.hitsteps.com\/blog\/wp-json\/wp\/v2\/posts\/3697","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.hitsteps.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.hitsteps.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.hitsteps.com\/blog\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/www.hitsteps.com\/blog\/wp-json\/wp\/v2\/comments?post=3697"}],"version-history":[{"count":0,"href":"https:\/\/www.hitsteps.com\/blog\/wp-json\/wp\/v2\/posts\/3697\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.hitsteps.com\/blog\/wp-json\/wp\/v2\/media?parent=3697"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.hitsteps.com\/blog\/wp-json\/wp\/v2\/categories?post=3697"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.hitsteps.com\/blog\/wp-json\/wp\/v2\/tags?post=3697"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}