Repository navigation
Conversation
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…es and non-string ids are new Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…older result Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…gestion warning Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…il wording on capture v1
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…equest Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…decisions Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…gits Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* docs(libraries): add the capture v1 SDK upgrade guide Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(libraries): note the distinct ID limit and group identify IDs on capture v1 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(libraries): call the $ settings properties legacy option properties Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(libraries): drop product_tour_id from the options table Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(libraries): add a limits section to the capture v1 upgrade guide Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(libraries): before_send must keep distinct_id a string Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(capture-v1): note that tracing headers are opt-in for Go and Python Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(capture-v1): drop the tracing header note; v1 keeps reading them by default Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(capture-v1): repeated uuids keep the first event Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(capture-v1): duplicate uuid note now waits only on SDK support Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(capture-v1): SDKs report dropped duplicate copies; mark 404/429 retries as undecided Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(capture-v1): reword the retry TODO comment * docs(capture-v1): Go nested modules move to /v2; link the iOS 4.0 guide * docs: list feature flag properties with the values the SDK adds Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs: list trace IDs with the SDK values and the GeoIP default per SDK Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(capture-v1): SDKs follow only same-origin 307 and 308 redirects Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(sdks): list product_tour_id in the capture v1 option table Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(sdks): list the historical migration setting for capture v1 SDKs Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(sdks): resolve capture v1 SDK guide TODOs, add Android and Node details Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(sdks): proxy checklist for capture v1 headers; link the fixed proxy guides Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(sdks): proxies must accept 20MB requests for capture v1 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(capture-v1): sdks retry 404 and 429 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(libraries): drop the checked AI property names note * docs(libraries): scope the $set merge and group rules to the SDKs that follow them * docs(libraries): say which Authorization values a proxy must keep Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(libraries): keep every PostHog key type in the proxy note Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(libraries): ask users to check before_send hooks for the v1 event shape Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(capture-v1): fix sdk upgrade page links, scope, and settings Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(capture-v1): sdks always write three timestamp digits Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(capture-v1): node drops a non-string hook distinct id too Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs: link capture v1 from capture, data, AI, and SDK pages (#21387) * docs: link capture v1 from the capture, data, AI, and SDK pages Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs: note that capture v1 drops long distinct IDs instead of shortening them Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs: separate the SDK page callouts from their TODO comments so MDX parses Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(data): describe capture v1 duplicate uuid handling as keep-first, drop-rest * docs(migrate): link capture v1 for historical migrations Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs: capture v1 paths for self-hosted proxies and upgrades; v1 AI needs no $ai_model Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(self-host): v1 sdks retry 404 before dropping Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs: fix the Flutter capture v1 platforms and drop the checked warning titles note * docs(capture-v1): add android callout and fix cross-link wording Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(data): disable_skew_correction still clamps far-future timestamps Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
…ippets Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
# Conflicts: # contents/docs/_snippets/identify-intro.mdx # contents/docs/libraries/react-native/index.mdx # gatsby-config.js # src/navs/activeMenu.test.ts # vercel.json
This PR replaces the hand-written iOS, Android, Flutter, and React Native pages, so the build must write their reference pages. The web SDK docs stay hand-written, so the build still skips posthog-js. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…versions as 8.x.x and 8.0.0 The capture v1 table on "Choosing a PostHog SDK" linked the Node.js migration guide on GitHub. It now links /docs/libraries/node/migration, like the other SDKs, and each SDK name links its reference page. Version numbers now use the 8.x.x and 8.0.0 form, which the migration page titles also use. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
# Conflicts: # contents/docs/product-analytics/identify.mdx
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…to eli/capture-v1-api-reference
…-api-reference One conflict, in mcp-analytics/installation/typescript.mdx: keeps master's note on the default tool arguments (#22354) under the options table, then this branch's Event options section.
posthog-node 6.0 reads only beforeSend (posthog-js #5757), so the Node.js before_send examples would be silently ignored. The error tracking capture page and the before-send snippet now show beforeSend for Node.js with a Node example; the React email page installs posthog-node@6; the capture v1 types note names both hook spellings.
…tion filter key - Rewrite the en-dash connectors this PR added as sentences, commas or colons. - Name the minimum versions for event options: @posthog/ai 8.21.0 and @posthog/mcp 1.3.0 (their pending minor changesets on capture-v1). - The web and React Native before-send examples filtered on exception["$exception_type"], which no SDK sets on $exception_list entries; posthog-js core's ErrorPropertiesBuilder sets `type`, so the filter never matched. They now check `type`, as the Node.js example does.
…list This PR replaces those four SDK pages with generated references, which are not MDX, so the SDK list on the Integrate page lost them. They are listed explicitly with their references, as LibraryComparison already does.
This PR redirects the Node.js, Python, Go and Rust landing pages to their generated references, so a build that warns past a failed Strapi fetch would deploy 404s for those SDKs. The fetch now retries twice, and `gatsby build` fails (reporter.panicOnBuild) when it still fails or when a published SDK has no reference.md; `gatsby develop` only logs. On Vercel a failed build keeps the previous deployment live.
Keeps this branch's delete of contents/docs/libraries/react-native/index.mdx; the React Native reference has the setAppLanguage section #22285 added there. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Conflicts in gatsby-config.js, gatsby/sdkMarkdownReferences.js, src/components/LibraryComparison/index.tsx, src/navs/activeMenu.test.ts and vercel.json: keep this branch's mobile and React Native additions next to master's server SDK lines. Restore `const client` in LibraryComparison, which the earlier merge 1aa8a8f dropped while the mobile rows still use it, so the build no longer fails with "ReferenceError: client is not defined". Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ster These pages moved to their own PRs: sdk-markdown-reference-ios, sdk-markdown-reference-android, and sdk-markdown-reference-flutter. This PR keeps React Native only. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This was referenced Nov 18, 2026
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Changes
This PR moves the iOS, Android, Flutter, and React Native docs to their Markdown reference pages. It holds the mobile part of #22061, so #22061 can land before the mobile majors ship. Merge it after posthog-ios 4.0.0, posthog-android 4.0.0, posthog_flutter 6.0.0, and posthog-react-native 5.0.0 publish their references.
posthog-react-nativeHogRef pages redirect to/docs/libraries/<sdk>/reference. Old redirects to the mobile pages now go to the reference pages.Screenshots of the nav come before this PR leaves draft.
Checklist
vercel.json🤖 Generated with Claude Code
Update: the build publishes the mobile references, and the web SDK stays as it is on master
posthog-ios,posthog-android,posthog-flutter, andposthog-react-nativetoPUBLISHED_SDK_REFERENCES, so the build writes their pages when this PR merges. Before this PR merges, the build skips them.posthog-jsredirects and no links to/docs/libraries/js/reference.Not tested: a local build of this PR.
Update: this PR holds React Native only
The iOS, Android, and Flutter parts moved to their own PRs, so each SDK can merge after its own release:
This PR merges after posthog-react-native 5.0.0 publishes its references.