WordPress

Add Humblytics to your WordPress site in about 3 minutes.

You need: admin access to install plugins. On WordPress.com, that means a plan that allows plugins.

1. Copy your tracking code

In Humblytics, open Site settings → Install and click Copy tracking code. Adding a new site? The code appears in step 2 of Add Site.

Copy the whole snippet, from <!-- Start Humblytics Tracking Code --> to <!-- End Humblytics Tracking Code -->.

2. Paste it into WordPress

The easiest way is the free WPCode plugin. It keeps the script in place when you change or update your theme.

1. Go to Plugins → Add New, search for WPCode, then click Install Now and Activate.

2. Go to Code Snippets → Header & Footer.

3. Paste the snippet into Header and click Save Changes.

Prefer code? In a child theme's functions.php, print the snippet inside a wp_head action. Avoid editing the parent theme's header.php: theme updates overwrite it.

3. Clear cache and verify

1. Clear your caching plugin and any CDN cache (Cloudflare, host cache). Otherwise visitors keep getting the old page without the script.

2. Back in Humblytics, click Verify install.

3. Open your live site in a private window and click around. Your visit appears in Observe → Analytics → Overview under Live Activity within about a minute.

Installed but not tracking?

A JavaScript optimization setting is the usual cause. Features that combine, minify, defer, or delay JavaScript can break the Humblytics script even though it's in your page. Exclude it in the tool you use, using both keywords hmbl.min.js and _hmblReveal:

Tool	Where to exclude
WP Rocket	Settings → WP Rocket → File Optimization: add both keywords to the exclusions for Minify/Combine JavaScript and Delay JavaScript execution
SiteGround Optimizer	Frontend → JavaScript: exclude Humblytics from Combine and Defer
W3 Total Cache	Performance → Minify: add hmbl.min.js to Never minify the following JS files
LiteSpeed Cache	Page Optimization → Tuning: add both keywords to JS Excludes and JS Deferred / Delayed Excludes
Cloudflare Rocket Loader	Turn it off, or add data-cfasync="false" to both <script> tags in the snippet

Clear all caches after changing these settings, then verify again.

Also check that security plugins (Wordfence, Sucuri) aren't blocking app.humblytics.com. More fixes: Verify & Troubleshoot Tracking.