The WordPress way to install Clarity is clunky
You want heatmaps and session recordings without paying Hotjar subscription prices. Microsoft Clarity is completely free but installing it still means editing a theme file or adding a plugin.
The canonical WordPress paths are: install an analytics plugin (comes with admin pages, updates, subscription nags), paste the snippet into functions.php (breaks when you switch themes), or set up Google Tag Manager as middleware (overkill for one pixel).
What most people do instead
A better way: one command, one ID, tracking live
Run enable clarity with your Project ID. The command auto-registers as a startup command so the tracking snippet outputs on every page load. No theme edit, no plugin, no GTM middleware.
Consent-aware flag included. Pass -consent_aware=true and the pixel only fires when your cookie-consent plugin's gate has been accepted. Works with any standard WP consent plugin that sets a cookie flag.
How it works
The command hooks wp_head with the Microsoft-provided tracking snippet, then auto-registers itself in Startup Commands so the tracking stays active across requests. Re-running with a different ID updates the existing entry. Disable from Startup Commands to remove.
enable clarity -cid=abcdefghij| Parameter | Value |
|---|---|
-cid(required) | Project ID (format: abcdefghij) |
-consent_aware | true to only fire after cookie consent (checks standard consent cookie) |
| Scope | Auto-registered as startup command — runs on every frontend page load |
| Where to find the ID | Clarity dashboard → Settings → Overview |
| Can be used in |
Real example
A client asks why users abandon their checkout. Google Analytics shows the funnel but not the why. Clarity's session recordings would answer — but you don't want to commit to Hotjar's pricing just to investigate. Run enable clarity -cid=abc123def, let it collect for a week, then watch recordings to spot where users get stuck.