NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #4153 most downloaded on npm
Type definitions for the PostHog JavaScript SDK
Latest stable
1.425.1
Last release 9 days ago
13 Nov 2026
Ships on a steady schedule
a new release about every 9 days
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
10 months old
280 releases · first in 2026
Drag across the ruler to compare, or tap a release to open it.
### Minor Changes - #3547 `4c0c7d9` Thanks @williamchong! - capture() now accepts an optional uuid on CaptureOptions. (2026-05-11) ### Patch Changes -
4c0c7d9 Thanks @williamchong! - capture() now accepts an optional uuid on CaptureOptions.
(2026-05-11)0a835fa Thanks @marandaneto! - Skip remote config background refreshes when no document is available.
(2026-05-11)Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
### Patch Changes - #3453 `96f19b7` Thanks @turnipdabeets! - Lift OTLP log serialization helpers from posthog-js into @posthog/core so the upcoming Re
96f19b7 Thanks @turnipdabeets! - Lift OTLP log serialization helpers from posthog-js into @posthog/core so the
upcoming React Native logs feature consumes the same builders. Browser gains
two fixes as a side effect: NaN and ±Infinity attribute values no longer get
silently dropped during JSON encoding, and the scope.version OTLP field is
now populated with the SDK version (changes the server's instrumentation_scope
column from "posthog-js@" to "posthog-js@<semver>"). (2026-04-23)Nothing published for this version
Also exposes patchFetchForTracingHeaders from @posthog/core so non-browser SDKs can reuse the implementation. (2026-04-23)
#3432 1a8b727 Thanks @richardsolomou! - refactor: rename __add_tracing_headers to addTracingHeaders. The __ prefix signalled an internal/experimental option, but the config is a public API (documented for linking LLM traces to session replays). __add_tracing_headers continues to work as a deprecated alias on the browser SDK.
Also exposes patchFetchForTracingHeaders from @posthog/core so non-browser SDKs can reuse the implementation. (2026-04-23)
Nothing published for this version
### Minor Changes - #3389 `922a1c1` Thanks @hpouillot! - Add exception steps to error tracking (aka breadcrumbs) (2026-04-22)
922a1c1 Thanks @hpouillot! - Add exception steps to error tracking (aka breadcrumbs)
(2026-04-22)Nothing published for this version
Nothing published for this version
Nothing published for this version
### Patch Changes - #3386 `4a65604` Thanks @dustinbyrne! - Add a preview flag for versioned browser lazy bundle asset paths. (2026-04-16)
4a65604 Thanks @dustinbyrne! - Add a preview flag for versioned browser lazy bundle asset paths.
(2026-04-16)Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
### Minor Changes - #3345 `3fcf5c4` Thanks @jonmcwest! - Add posthog.captureLog() API for sending structured log entries to PostHog logs (2026-04-13)
3fcf5c4 Thanks @jonmcwest! - Add posthog.captureLog() API for sending structured log entries to PostHog logs
(2026-04-13)Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
### Patch Changes - #3323 `c387f6d` Thanks @pauldambra! - perf(replay): reduce memory and CPU cost of event compression by caching gzipped empty array
c387f6d Thanks @pauldambra! - perf(replay): reduce memory and CPU cost of event compression by caching gzipped empty arrays and eliminating redundant JSON.stringify for size estimation
(2026-04-08)Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
### Patch Changes - #3274 `ba08262` Thanks @pauldambra! - fix: document visibility change shoudln't capture dead click (2026-03-25)
ba08262 Thanks @pauldambra! - fix: document visibility change shoudln't capture dead click
(2026-03-25)Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
### Patch Changes - #3245 `1acd6fd` Thanks @dmarticus! - handle plain array and object forms in overrideFeatureFlags (2026-03-20)
1acd6fd Thanks @dmarticus! - handle plain array and object forms in overrideFeatureFlags
(2026-03-20)Nothing published for this version
Nothing published for this version
### Minor Changes - #3241 `fe1fd7b` Thanks @dustinbyrne! - feat: add advanced_feature_flags_dedup_per_session config option to scope $feature_flag_cal
fe1fd7b Thanks @dustinbyrne! - feat: add advanced_feature_flags_dedup_per_session config option to scope $feature_flag_called deduplication to the current session
(2026-03-18)Nothing published for this version
Nothing published for this version
### Minor Changes - #3207 `c5a37cb` Thanks @dustinbyrne! - feat: Add TreeShakeable (2026-03-09)
c5a37cb Thanks @dustinbyrne! - feat: Add TreeShakeable<T>
(2026-03-09)Nothing published for this version
One column per month.