Skip links
View Categories

Tracking not working: checklist

1 min read

  1. Setup check – How it works page: visits received? tracker blocked? own visits counted? Follow its buttons.
  2. Script present – view the page source in a private window and search for opti-behavior.
  3. Cache – purge page cache, object cache and CDN; exclude the trackers from JS delay if you use one.
  4. Consent – in Full Tracking, accept the banner when testing.
  5. Not a bot, not spam – stay 20+ seconds and click; very short tests can be classed as spam.
  6. Not excluded – your IP is not in Excluded IPs; admin tracking is on if you test logged in.
  7. Background tasks – if numbers never update, WP-Cron may be off: set a server cron.
  8. Debug – enable debug logging, reproduce, send the log to support.

Specific cases #

SymptomCauseFix
Sessions appear but no heatmapArchive page, or no clicksSee heatmap troubleshooting
Heatmaps but no recordingsRecording off, no consent, quotaSee recordings troubleshooting
Only your own visitsSite not public yet or cached without trackerPurge cache; check robots/maintenance mode
Numbers stop updatingWP-Cron not runningSet a server cron
All visits flagged spamThresholds too strictLower them in Traffic & Behavior

FAQ #

How long until a visit shows up? #

Real-time visitors within seconds; some dashboard widgets update on a short cycle.

Check the requests #

  1. Open your site in a private window and the browser DevTools → Network tab.
  2. Click and scroll a little.
  3. You should see small requests from your own domain a few seconds later. None? The tracker is not running: back to the cache step.
  4. Requests with errors (403, 500)? A security plugin or firewall may block them; allow requests from your own pages.

Expected result #

A private-window visit appears in Real-time Visitors within a minute.

Leave a comment

Explore
Drag