Repository navigation
docs(billing): add "What you actually get when you pay for a session recording" - #22307
Open
joethreepwood wants to merge 4 commits into
Open
joethreepwood wants to merge 4 commits into
joethreepwood wants to merge 4 commits into
Conversation
…recording" Add a billing doc that explains what the price of one session recording covers, from the recorder to playback, with a ledger to compare it with a self-built replay setup. Add a Common questions block to the event doc, a Billing nav entry, and cross-links from related billing and replay pages. Generated-By: PostHog Desktop Task-Id: 590db4f3-d717-43f8-bfa0-4ae6c5e0819c
Contributor
Deploy preview
Changed pages
|
Contributor
|
Vale prose linter → found 2 errors, 49 warnings, 1 suggestions in your markdown Full report → Copy the linter results into an LLM to batch-fix issues. Linter being weird? Update the rules!
|
| Line | Severity | Message | Rule |
|---|---|---|---|
| 4:53 | warning | Use 'PostHog' instead of 'posthog'. | Vale.Terms |
| 21:121 | warning | Capitalize 'Surveys' for PostHog's product. Use 'surveys' for the general industry concept. | PostHogBase.ProductNames |
| 27:207 | warning | Avoid trivializing words. 'easy to' can sound dismissive to the reader. | PostHogDocs.Trivializers |
| 33:71 | warning | Avoid trivializing words. 'easy to' can sound dismissive to the reader. | PostHogDocs.Trivializers |
| 35:1 | warning | Avoid trivializing words. 'Simply' can sound dismissive to the reader. | PostHogDocs.Trivializers |
| 37:52 | error | Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. | PostHogBase.EnDash |
| 41:5 | warning | 'Option 2: Estimate based on your product category and/or MAUs' heading should be in sentence case, and product names should be capitalized. | PostHogBase.SentenceCase |
| 41:62 | warning | 'MAUs' is a possible misspelling. | PostHogBase.Spelling |
| 45:6 | warning | 'Estimating session replay volume based on MAUs' heading should be in sentence case, and product names should be capitalized. | PostHogBase.SentenceCase |
| 45:17 | warning | Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. | PostHogBase.ProductNames |
| 45:48 | warning | 'MAUs' is a possible misspelling. | PostHogBase.Spelling |
| 49:75 | warning | 'MAUs' is a possible misspelling. | PostHogBase.Spelling |
| 59:6 | warning | 'Estimating event volume based on MAUs' heading should be in sentence case, and product names should be capitalized. | PostHogBase.SentenceCase |
| 59:39 | warning | 'MAUs' is a possible misspelling. | PostHogBase.Spelling |
| 61:42 | warning | 'MAUs' is a possible misspelling. | PostHogBase.Spelling |
| 61:342 | warning | 'MAUs' is a possible misspelling. | PostHogBase.Spelling |
| 145:1 | warning | Capitalize 'Feature Flags' for PostHog's product. Use 'Feature flags' for the general industry concept. | PostHogBase.ProductNames |
| 145:19 | warning | Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. | PostHogBase.ProductNames |
| 173:7 | warning | Capitalize 'Product Analytics' for PostHog's product. Use 'product analytics' for the general industry concept. | PostHogBase.ProductNames |
| 174:7 | warning | Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. | PostHogBase.ProductNames |
| 175:7 | warning | Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. | PostHogBase.ProductNames |
contents/docs/billing/what-you-pay-for-per-event.mdx — 0 errors, 9 warnings, 0 suggestions
| Line | Severity | Message | Rule |
|---|---|---|---|
| 27:17 | warning | Use the Oxford comma before 'and' or 'or' in a list of three or more items. | PostHogBase.OxfordComma |
| 65:220 | warning | 'cookieless' is a possible misspelling. | PostHogBase.Spelling |
| 73:1 | warning | Avoid trivializing words. 'Simply' can sound dismissive to the reader. | PostHogDocs.Trivializers |
| 75:180 | warning | 'NVMe' is a possible misspelling. | PostHogBase.Spelling |
| 113:49 | warning | 'cookieless' is a possible misspelling. | PostHogBase.Spelling |
| 115:39 | warning | 'tiering' is a possible misspelling. | PostHogBase.Spelling |
| 116:149 | warning | 'else's' is a possible misspelling. | PostHogBase.Spelling |
| 147:361 | warning | Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. | PostHogBase.ProductNames |
| 192:54 | warning | Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. | PostHogBase.ProductNames |
contents/docs/billing/what-you-pay-for-per-recording.mdx — 0 errors, 13 warnings, 1 suggestions
| Line | Severity | Message | Rule |
|---|---|---|---|
| 11:40 | warning | 'rrweb' is a possible misspelling. | PostHogBase.Spelling |
| 33:3 | warning | Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. | PostHogBase.ProductNames |
| 35:298 | warning | Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. | PostHogBase.ProductNames |
| 66:434 | warning | 'else's' is a possible misspelling. | PostHogBase.Spelling |
| 84:219 | suggestion | Address the reader directly. Use 'you' instead of 'the user'. | PostHogDocs.DirectAddress |
| 86:185 | warning | 'rrweb' is a possible misspelling. | PostHogBase.Spelling |
| 86:242 | warning | Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. | PostHogBase.ProductNames |
| 96:119 | warning | Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. | PostHogBase.ProductNames |
| 108:126 | warning | 'rrweb' is a possible misspelling. | PostHogBase.Spelling |
| 112:112 | warning | 'rrweb's' is a possible misspelling. | PostHogBase.Spelling |
| 129:1 | warning | 'rrweb' is a possible misspelling. | PostHogBase.Spelling |
| 172:58 | warning | 'rrweb' is a possible misspelling. | PostHogBase.Spelling |
| 193:32 | warning | 'rrweb' is a possible misspelling. | PostHogBase.Spelling |
| 201:140 | warning | Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. | PostHogBase.ProductNames |
contents/docs/session-replay/recording-retention.mdx — 1 errors, 1 warnings, 0 suggestions
| Line | Severity | Message | Rule |
|---|---|---|---|
| 11:102 | warning | Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. | PostHogBase.ProductNames |
| 35:247 | error | Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. | PostHogBase.EnDash |
contents/tutorials/limit-session-recordings.mdx — 0 errors, 6 warnings, 0 suggestions
| Line | Severity | Message | Rule |
|---|---|---|---|
| 25:4 | warning | 'Configuration and basic session replay controls' heading should be in sentence case, and product names should be capitalized. | PostHogBase.SentenceCase |
| 25:28 | warning | Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. | PostHogBase.ProductNames |
| 53:74 | warning | Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. | PostHogBase.ProductNames |
| 70:28 | warning | Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. | PostHogBase.ProductNames |
| 72:28 | warning | Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. | PostHogBase.ProductNames |
| 88:18 | warning | Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. | PostHogBase.ProductNames |
joethreepwood
marked this pull request as draft
November 13, 2026 10:52
Contributor
There was a problem hiding this comment.
PostHog Review · Standard · reviewed da5914b: 2 Should fix.
See this review and its findings in PostHog Review. Comment @posthog review --deep for a Deep review. A Deep review takes longer and looks deeper than a Standard review.
Disclose that AI replay search spends AI credits, and distinguish the recorder's lazy download from upload eligibility when triggers or a minimum duration are set. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Generated-By: PostHog Desktop Task-Id: aa18d59a-ad85-4895-8882-c0301b07184a
Contributor
Bundle reportTotal JS (gzip)12.22 MiB (+157.8 KiB / +1.3%) Largest changed named chunks
Eager graph (modules shipped in each entrypoint's initial chunks)
Largest modules in the
|
| Module | Size |
|---|---|
css ./node_modules/.pnpm/css-loader@5.2.7_webpack@5.101.3/node_modules/css-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[1]!./node_modules/.pnpm/postcss-loader@4.3.0_postcss@8.5.6_webpack@5.101.3/node_modules/postcss-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[2]!./src/styles/global.css |
1023.1 KiB |
./src/components/Stickers/Stickers.tsx |
696.4 KiB |
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/puzzle.mjs |
388.5 KiB |
./node_modules/.pnpm/@posthog+icons@0.36.6_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.es.js |
354.8 KiB |
./node_modules/.pnpm/react-markdown@8.0.7_@types+react@16.14.66_react@18.3.1/node_modules/react-markdown/lib/react-markdown.js + 88 modules |
351.4 KiB |
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/basketball-coach.mjs |
337.4 KiB |
./node_modules/.pnpm/framer-motion@14.0.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/framer-motion/dist/es/render/components/motion/proxy.mjs + 126 modules |
287.2 KiB |
./node_modules/.pnpm/cloudinary-core@2.14.0_lodash@4.17.21/node_modules/cloudinary-core/cloudinary-core.js |
281.9 KiB |
./src/components/SearchUI/index.tsx + 87 modules |
273.1 KiB |
./gatsby-browser.tsx + 60 modules |
259.4 KiB |
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/construction-1.mjs |
248.5 KiB |
./src/components/Pricing/PricingSlider/Slider.tsx + 87 modules |
240.2 KiB |
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/construction-2.mjs |
228.2 KiB |
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/magnifying-glass.mjs |
221.7 KiB |
./src/hooks/useProduct.ts + 18 modules |
166.5 KiB |
Eager-graph budgets are report-only until a baseline is established. Sizes are gzip of public/**/*.js; eager size is webpack module source bytes for the modules actually shipped in the entrypoint's initial chunks (post-tree-shake).
joethreepwood
commented
Nov 16, 2026
Co-authored-by: Joe Black <84011561+joethreepwood@users.noreply.github.com>
Apply the remaining suggestion on the privacy step. Fix typos from the batched suggestions: "it's own", a doubled "the", "five second", "neither ... or", and a stray parenthesis in the tutorial link. Generated-By: PostHog Desktop Task-Id: 590db4f3-d717-43f8-bfa0-4ae6c5e0819c
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.
Summary
This PR adds a new billing doc, What you actually get when you pay for a session recording. It is a sibling of What you actually get when you pay for an event (#21895), and it uses the same structure and tone.
The doc tells a reader what the price of one session recording pays for. It follows a recording through six steps: recording it, keeping private data private, not losing it, storing it, watching it, and finding it. Then it gives a table to compare PostHog with a self-built replay setup, a ledger that the reader completes with their own numbers, the cases where building is the better choice, and ways to lower the bill.
The main point of the doc: recording is the easy part, because rrweb is free and open source. Most of the cost is in the work around it, such as a safe recorder, masking, a player, and search. The doc also says that storage is the cheap part of replay.
A separate page is better than a new section in the event doc. Recordings have a different pipeline, a different billing unit, and different retention. People also search for replay cost separately from event cost.
Changes
contents/docs/billing/what-you-pay-for-per-recording.mdxsrc/navs/index.js. This file is "ask first" inCLAUDE.md. The change only adds an entry.billing/common-questions.md(a new "What does the price of a session recording include?" section),billing/estimating-usage-costs.mdx,session-replay/recording-retention.mdx, andtutorials/limit-session-recordings.mdx.This is a content PR. It does not change /pricing. No page moves, so no redirect is necessary.
Sources
/pricing.md). The doc shows the rates with the existing<Pricing productType="session_replay" />component. The free tiers are also in the text (5,000 web and 2,500 mobile recordings), because answer engines may not read the component.docs/session-replay/recording-retention.mdx.docs/session-replay/privacy.mdx.docs/session-replay/mobile.mdx.handbook/engineering/session-replay/session-replay-architecture.md.Nav screenshots
Each image shows before (posthog.com, left) and after (PR preview, right). The new entry is directly after "What you actually get when you pay for an event". Narrow is 640 px and wide is 1440 px.
Checks
estimating-usage-costs.mdx:37andrecording-retention.mdx:35. They are on lines that this PR does not change. CI "Lint prose with Vale" passes.<Pricing>component on the new doc shows the live Session Replay rates ($0.005 to $0.0015 per recording), which agree with/pricing.md.width="auto"error, and a 404. These errors are not from this PR. The live event doc on posthog.com shows the same 90 errors, and an unchanged preview page that also uses<Pricing>(/docs/logs/pricing) shows the same error types.createPagesfails locally withCannot query field "allSdkMarkdownReference", so no docs pages render. This PR did not cause that failure. I did the checks on the PR preview.Created with PostHog Desktop from a PostHog Desktop task