Posthog Release Notes

1.397.0

Minor Changes

• #4089 cc340db Thanks @bs1180! - feat(web): add a posthog-js/customizations subpath entry point exposing the optional customizations (setAllPersonProfilePropertiesAsPersonPropertiesForFlags, the before-send sampling helpers, and the redux/kea loggers) as a proper ES module with bundled types, replacing the internal posthog-js/lib/src/customizations deep import. Also fixes the TypeScript definitions so setAllPersonProfilePropertiesAsPersonPropertiesForFlags accepts the instance passed to the loaded callback (the documented usage), and the loaded callback's instance type now includes config.

(2026-07-06)

1.396.8

Patch Changes

#4062 2af0026 Thanks @posthog! - fix(web): prevent an infinite-recursion stack overflow in the logs console capture. The console wrapper's own capture path can emit internal debug lines through PostHog's logger, which wrote back to the wrapped console and re-entered capture until the stack blew (RangeError: Maximum call stack size exceeded). The wrapper now exposes the original console method via rrweb_original (so the internal logger bypasses it) and guards against re-entrancy from any code that logs mid-capture.

(2026-07-06)

4.54.4

Patch Changes

• #4031 94a0530 Thanks @posthog! - Improve survey display reliability:
• posthog-js: refresh the cached $surveys definitions after a short TTL (stale-while-revalidate) so server-side changes such as switching a survey from popover to API propagate to long-lived tabs without a page reload.
• posthog-js: add posthog.surveys.markSurveyAsSeen(surveyId, { iteration }) so custom integrators that render surveys through their own backend can honour the "already seen" and wait-period checks.
• posthog-react-native: guarantee the survey Modal notifies its parent on close even when iOS Modal.onDismiss fails to fire, so the transparent full-screen modal can no longer stay mounted intercepting touches and freezing the app. (2026-07-03)

Updated dependencies [45d1b36]:

• @posthog/[email protected]

1.396.6

Patch Changes

• #4053 45d1b36 Thanks @posthog! - feat(web): add a graceful shutdown() to the browser client for parity with posthog-node, so isomorphic teardown code (e.g. the Nuxt module) that calls posthog.shutdown() on the client no longer throws TypeError: shutdown is not a function. It best-effort flushes the queued events and always resolves.
  (2026-07-03)

• #4054 f0657eb Thanks @posthog! - fix(web): detect our own feature-flag request timeouts via a timedOut flag instead of the abort reason, so they are logged at warn (not error) on browsers that don't propagate controller.abort(reason) — keeping benign timeouts out of error tracking's console-error capture
  (2026-07-03)

• #4031 94a0530 Thanks @posthog! - Improve survey display reliability:
  posthog-js: refresh the cached $surveys definitions after a short TTL (stale-while-revalidate) so server-side changes such as switching a survey from popover to API propagate to long-lived tabs without a page reload.
  posthog-js: add posthog.surveys.markSurveyAsSeen(surveyId, { iteration }) so custom integrators that render surveys through their own backend can honour the "already seen" and wait-period checks.
  posthog-react-native: guarantee the survey Modal notifies its parent on close even when iOS Modal.onDismiss fails to fire, so the transparent full-screen modal can no longer stay mounted intercepting touches and freezing the app.
  (2026-07-03)

Updated dependencies [45d1b36]:
@posthog/[email protected]

0.8.0

Minor Changes

• #4032 93bbc4b Thanks @lucasheriques! - Stamp $mcp_error_type and $mcp_error_message on $mcp_tool_call (and $mcp_tools_list) when a call fails. Previously the only failure signal on the primary event was the $mcp_is_error boolean, so breaking failures down by reason meant joining to the $exception sibling (which can be disabled, and isn't emitted when no error value is passed). $mcp_error_type defaults to the thrown error's type, and captureToolCall/captureToolsList accept an explicit low-cardinality errorType label (e.g. validation, permission, timeout, rate_limited) for hosts that classify their own failures.

(2026-07-03)

2.0.32

Patch Changes

• #4061 cc01eea Thanks @turnipdabeets! - Gate the feature-flag local-evaluation refresh loop so it no longer runs on installs that don't use it. The self-rescheduling loop and its 5-minute supervisor now no-op unless POSTHOG_PERSONAL_API_KEY is set — event-only and remote-flag projects no longer incur ~3k/day skipped scheduled executions or the log churn they produced. Adds POSTHOG_DISABLE_LOCAL_EVALUATION as an explicit off-switch for projects that set a key but don't want the background poll. Behavior is unchanged when a key is configured.

(2026-07-03)