references/fixing-cookieless-warnings.md
Fixing the cookieless warnings
A cookieless-mode event was dropped: either the project has not enabled cookieless tracking, or one of the hash inputs for the cookieless distinct ID (timestamp, user agent, IP, host) was missing or invalid.
Category event, severity error for all six types: the event cannot be ingested at all.
cookieless_team_disabled: the project setting is off
The SDK sent the event in cookieless mode (cookieless_mode: "always" or "on_reject" in posthog-js, sentinel distinct ID $posthog_cookieless), but Cookieless tracking is disabled in the project settings (Settings → Web analytics → Cookieless tracking, stored as cookieless_server_hash_mode). Ingestion drops every such event before any identity is computed, so heatmap events and exception captures sent in cookieless mode are dropped the same way. The events still show in Live events, because that view reads the stream before the pipeline runs, which is why this looks like PostHog accepting data and losing it.
The server-side gate is deliberate: without it, anyone holding the public project token could force cookieless processing on a project that never opted in, which strips IP and user agent. So the fix is a settings change, not a code change:
- Enable Cookieless tracking in Settings → Web analytics if the project wants cookieless mode. Events sent after the change land immediately; the ones already dropped are gone.
- Or remove
cookieless_modefrom the posthog-js config if cookieless was enabled in the SDK by accident.
Verify by re-querying system.ingestion_warnings with posthog:execute-sql (filter type = 'cookieless_team_disabled', timestamp after the change) — no new occurrences — and confirm cookieless events appear in Explore with computed anonymous IDs.
The rest of this file covers the five hash-input warnings, which only fire once the setting is on.
How cookieless identity works (why these fields are mandatory)
In cookieless mode the client stores nothing — events arrive with the sentinel distinct ID $posthog_cookieless, and PostHog computes a rotating anonymous ID server-side by hashing calendar day + user agent + IP + host. Every warning in this family is one missing hash input:
| Type | Missing hash input |
| ----------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| cookieless_missing_timestamp | No usable timestamp (event timestamp, sent_at, or arrival time) |
| cookieless_timestamp_out_of_range | Timestamp's calendar day isn't plausibly current — in the future, or further past than ingestion lag allows |
| cookieless_missing_user_agent | No $raw_user_agent property |
| cookieless_missing_ip | No $ip property |
| cookieless_missing_host | No $host property |
The daily rotation is the privacy property — and it means cookieless has a built-in constraint: events must arrive close to when they happened. Old events can't be identified retroactively, by design.
Who supplies which hash input (browser flow): posthog-js sends $raw_user_agent and $host on every event; $ip is never sent by the client — capture records the connection's client IP and ingestion attaches it as $ip when the property is absent. Stock posthog-js in cookieless mode therefore works with no extra setup.
Diagnose
Which hash input is missing points at which layer is broken:
- Query the warnings with
posthog:execute-sql:SELECT timestamp, details FROM system.ingestion_warnings WHERE type IN ('cookieless_missing_timestamp', 'cookieless_timestamp_out_of_range', 'cookieless_missing_user_agent', 'cookieless_missing_ip', 'cookieless_missing_host') AND timestamp > now() - INTERVAL 7 DAY ORDER BY timestamp DESC LIMIT 20(narrow to a singletypeto isolate one hash input). ThedetailsJSON carries the event name and UUID. - Map the missing field to the layer:
$raw_user_agent/$hostmissing → the events aren't coming from stock posthog-js: a non-browser producer sending the cookieless sentinel, or middleware (before_send, a rewriting proxy) stripping properties.$ipmissing → the capture path saw no client IP — a proxy/CDN in front of PostHog not passing the client address through, or middleware explicitly deleting$ipbefore the identity is computed.- timestamp missing → server-side batching that strips timestamps.
- timestamp out of range → a historical import routed through cookieless (can't work, see below), badly skewed client clocks, or offline queues flushing much later.
- If cookieless events produce no events and only
cookieless_team_disabledwarnings, the project setting is off — see the section above. Hash inputs are not checked until it is on.
Fix
- Browser via stock posthog-js: no properties to add — fix whatever strips them (a rewriting proxy, a
before_sendhook), and ensure any proxy in front of PostHog forwards the client IP. - Server-side capture (your backend relays browser traffic): explicitly set
$raw_user_agent,$host, and$ipfrom the original browser request on every cookieless event, and timestamp at capture time. The$ipis mandatory here even though no warning demands it while your server's IP fills the gap: without it, every user hashes on the server's IP and collapses into shared identities — silently, with no warning at all. - Privacy middleware: if something scrubs
$ipbefore PostHog, exempt cookieless events — the IP is a hash input, not stored as identity. - Historical imports/backfills: don't route them through cookieless — past calendar days can't be hashed. Imports need real distinct IDs.
- Late delivery: cookieless requires timely arrival; events buffered for days will be dropped as out-of-range. If the client legitimately buffers that long, cookieless is the wrong mode for it.
Verify
Re-run the flow, re-query system.ingestion_warnings with posthog:execute-sql (filter type IN ('cookieless_missing_timestamp', 'cookieless_timestamp_out_of_range', 'cookieless_missing_user_agent', 'cookieless_missing_ip', 'cookieless_missing_host'), timestamp after your fix) — no new cookieless_* occurrences — and confirm cookieless events appear with computed anonymous IDs.
Related
- fixing-ignored-invalid-timestamp.md — timestamp problems outside cookieless mode (kept at server time instead of dropped).