WordPress · free forever · no signup

Add a free click heatmap to WordPress

This guide shows how to add a WordPress heatmap in about a minute, with no plugin: you paste one snippet into your theme's header, before </head>, because it has to load on every page before your clicks happen, and it renders nothing visible. No plugin. WordPress accepts raw HTML in a Custom HTML block, which is all this needs.

What this WordPress heatmap shows

A click heatmap records where visitors click on each page and draws those clicks as a colour overlay, so the hot spots stand out at a glance. It answers practical questions quickly: do people click the main button, do they try to click things that aren't links, and which parts of a long page get clicked at all? It records clicks only. It doesn't record sessions or keystrokes, and it doesn't show anything to your visitors.

How to add a click heatmap to WordPress

  1. 1In WP Admin go to Tools → Theme File Editor (on older or classic themes it's Appearance → Theme File Editor).
  2. 2Pick header.php from the file list on the right.
  3. 3Find the closing </head> tag and paste the snippet on the line directly above it.
  4. 4Click Update File, then purge your caching plugin.
Block theme or a different editor? Block themes (Twenty Twenty-Four and friends) have no header.php. Use a header-scripts plugin such as WPCode, or your theme's Custom Code panel — anything that can inject into <head> sitewide works.

Where it works best on a WordPress site

On WordPress, the right spot is your theme's header, before </head>. Because it has to see every click, the heatmap loads once in the head of every page and renders nothing visible. Give it a week or two of normal traffic before drawing conclusions, and look at your most important pages first: the home page, your best-selling product or your main sign-up page.

WordPress plan and editor requirements

WordPress.org sites you host yourself can use every method on this page. On WordPress.com, adding scripts with a Custom HTML block or a header plugin needs a plan that allows plugins and custom code (the Business plan or above at the time of writing), because lower WordPress.com plans strip script tags. If you're not sure which you have, check whether your dashboard has a Plugins menu.

Three things that trip people up on WordPress

Purge your cache after pasting

WP Rocket, W3 Total Cache, LiteSpeed Cache and your host's edge cache all serve a stored copy of your HTML. Until you purge, you'll be looking at the version from before you pasted and assuming the widget is broken. The widget's own data is fetched client-side on every load, so page caching never makes the numbers go stale — it only hides a freshly-added snippet.

Exclude it from JS minify / combine

Optimisation plugins that concatenate or defer every script can break an async third-party tag by moving it out of order. If the widget renders nothing after a purge, add the script URL to your plugin's JS exclusion list — in WP Rocket that's File Optimization → Excluded JavaScript Files. Nothing else needs changing.

Use a Custom HTML block, never a paragraph

WordPress sanitises script tags typed into a paragraph or the Visual editor tab, silently. The Custom HTML block, the Classic editor's Text tab, and Elementor's HTML widget all pass markup through untouched. If your snippet vanished on save, that's why.

Honest limits

A heatmap shows what people did, not why. It can't replace talking to customers or a proper A/B test, and on pages with only a handful of visits the patterns are mostly noise.

What you get, and what it costs

  • Free forever — there is no paid tier, no trial and no card
  • No signup for the badge-style widgets; the live ones create a site ID inline from your URL
  • Async script — it never blocks your page from rendering
  • Works on any theme, classic or block, and inside every major page builder
  • Bots filtered server-side on every visitor-counting widget

WordPress questions

Do I need a plugin to add a click heatmap to WordPress?

No plugin. WordPress accepts raw HTML in a Custom HTML block, which is all this needs. Installing a plugin for this would mean another dependency and update cycle just to show one widget.

Where exactly does the snippet go on WordPress?

Your theme's header, before </head>, because it has to load on every page before your clicks happen, and it renders nothing visible.

Will it slow my WordPress site down?

It adds one small script, loaded asynchronously, so it doesn't block your page from rendering. Any third-party script has some cost, so check your page speed before and after adding it. Your caching and optimisation plugins keep working exactly as before — the only thing to remember is to purge the cache after you paste, otherwise you'll be looking at the stored copy of your old HTML.

Does it work with page builders like Elementor?

Elementor: drag in the HTML widget and paste there. Divi: use a Code module. Beaver Builder: use the HTML module. WPBakery: use the Raw HTML element. Any builder with a raw-HTML or code block will render it.

Does the heatmap record visitors' screens?

No. It records click positions on the page, not session videos, form input or keystrokes, and it isn't shown to your visitors.