I installed but see no data

Work top to bottom. Do not skip steps.

1) Key & project

• Key from Settings → Environments matches the project you are viewing in the sidebar
• Env var name matches the framework (NEXT_PUBLIC_… / VITE_… / public runtime config)
• Dev server restarted after env change
• Key not overwritten by a second init with an empty string
• You did not rotate the key in the UI without updating the app

2) Init actually runs in the browser

• Client component / browser entry (not a React Server Component)
• Breakpoint or log hits HumanBehaviorTracker.init once
• No early return because apiKey is undefined
• For Next App Router, leaf initializer pattern — not a broken provider wrap

3) Network

In DevTools → Network, filter ingestion:

/api/ingestion/init is optional/deprecated and is not required for a healthy install. Do not treat a missing init call as failure.

Also check:

• Not blocked by extension / ad blocker (net::ERR_BLOCKED_BY_CLIENT)
• ingestionUrl correct for local (http://localhost:8000 or your tunnel) vs prod (https://ingest.humanbehavior.co or your proxy)
• CORS / CSP not rejecting the host
• Response is not 429 monthly limit (SDK may go silent)

4) Minimum duration & idle

• You stayed on the page > 5 seconds (default minimumDurationMilliseconds) or set it to 0
• You actually interacted (click / navigate) so autocapture and replay have something to send
• Session did not immediately rotate because of clock / storage quirks — hard refresh once

5) Product UI filters

• Date range includes “now” (try Today / Last 24 hours)
• No leftover shared filters excluding everyone
• Hard refresh the HumanBehavior tab
• You are looking at the same project the key belongs to

6) Wait

Ingestion is near-real-time but not always instant. Use the app for 30–60s, wait up to a couple of minutes, refresh Replays and Dashboard.

7) Still stuck

Capture and share with your team:

• Failing request URL, status code, response body snippet
• Framework and whether wizard or manual install
• Whether init / events appear at all in Network
• SDK version from the package lockfile

Also see Install failures.

Related

• Verify
• Reverse proxy
• Init reference