Skip to content

docs(billing): add "What you actually get when you pay for a session recording" - #22307

Open
joethreepwood wants to merge 4 commits into
masterfrom
posthog/what-you-pay-for-per-recording
Open

joethreepwood wants to merge 4 commits into
masterfrom
posthog/what-you-pay-for-per-recording

Conversation

@joethreepwood

@joethreepwood joethreepwood commented Nov 13, 2026 •

Copy link
Copy Markdown
Contributor

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

  • New: contents/docs/billing/what-you-pay-for-per-recording.mdx
  • Event doc: a new "Common questions" section (4 questions, for AEO), and one sentence that links to the new doc. The answers use only facts that are already in the event doc.
  • Nav: one Billing entry directly after the event doc entry, in src/navs/index.js. This file is "ask first" in CLAUDE.md. The change only adds an entry.
  • Cross-links: one line each in 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, and tutorials/limit-session-recordings.mdx.

This is a content PR. It does not change /pricing. No page moves, so no redirect is necessary.

Sources

  • Prices and free tiers: the live billing data (/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.
  • Retention: docs/session-replay/recording-retention.mdx.
  • Masking and deletion: docs/session-replay/privacy.mdx.
  • Mobile capture: docs/session-replay/mobile.mdx.
  • Pipeline: handbook/engineering/session-replay/session-replay-architecture.md.
  • Recorder incident: the doc links the January 2026 Replay SDK post-mortem, in the same way that the event doc links the Logs post-mortem.

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.

Narrow Wide
Light
Dark

Checks

  • Ran Prettier on all changed files. The commit hook also ran Prettier, ESLint, and markdownlint.
  • Ran vale on all changed content files. The new doc has 0 errors. Its warnings are the word "rrweb" and lowercase general terms, for example "a session replay tool". There are 2 vale errors in estimating-usage-costs.mdx:37 and recording-retention.mdx:35. They are on lines that this PR does not change. CI "Lint prose with Vale" passes.
  • Loaded all 6 changed pages on the PR preview. Each page renders and has the new link. The Billing nav shows the new entry.
  • The <Pricing> component on the new doc shows the live Session Replay rates ($0.005 to $0.0015 per recording), which agree with /pricing.md.
  • Console: the new doc and the event doc show React hydration errors (Burger menu color fix #418 and Small fixes for pricing and free trial pages #423), an SVG 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.
  • All internal link targets exist in the repo.
  • I could not use the local dev server. On current master, createPages fails locally with Cannot 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

…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
@github-actions

github-actions Bot commented Nov 13, 2026 •

Copy link
Copy Markdown
Contributor

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Nov 16, 2026 04:09PM

Changed pages

Page Source
Common questions about billing contents/docs/billing/common-questions.md
Estimating usage & costs contents/docs/billing/estimating-usage-costs.mdx
What you actually get when you pay for an event contents/docs/billing/what-you-pay-for-per-event.mdx
What you actually get when you pay for a session recording contents/docs/billing/what-you-pay-for-per-recording.mdx
Replay recording retention contents/docs/session-replay/recording-retention.mdx
How to only record the sessions you want contents/tutorials/limit-session-recordings.mdx

@github-actions github-actions Bot added the docs Improvements or additions to product documentation, "Docs" label Nov 13, 2026
@github-actions

github-actions Bot commented Nov 13, 2026 •

Copy link
Copy Markdown
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!

contents/docs/billing/estimating-usage-costs.mdx — 1 errors, 20 warnings, 0 suggestions
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
joethreepwood marked this pull request as draft November 13, 2026 10:52

@posthog posthog Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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
@github-actions

github-actions Bot commented Nov 13, 2026 •

Copy link
Copy Markdown
Contributor

Bundle report

Total JS (gzip)

12.22 MiB (+157.8 KiB / +1.3%)

Largest changed named chunks
Chunk Gzip Δ vs master
f2dbc74af55ca99cdd38582a532e602146695d29.js 127.0 KiB new
e01beff9.js 77.9 KiB new
d1c09c67.js 68.4 KiB new
b3896404911e2bb789a64cebda263affb5a7eaef.js 49.0 KiB new
832eca2bd90f47d6886052db15970a4309b6d1e4.js 24.2 KiB new
bee98676a804cfae257c1a3b0f0275ad4a219da8.js 16.4 KiB new
d1ee37382485a75581197e428f3a15631c2de6cc.js 8.6 KiB new
0ac16b2a4f38f0508692f6e9f203b6550e76aac2.js 8.5 KiB new
aa5bd93166710ce0ee5edfad64efa881dce87ccb.js 7.0 KiB new
c1191f4ccc50033564d1c9c6a1d0e5b0510ecb9b.js 6.2 KiB new
component---src-pages-pocket-guides-index-tsx.js 5.1 KiB new
app.js 1130.7 KiB +5.0 KiB / +0.4%
1844cf53199445c5eb131ee91a2619418f65e92a.js 4.8 KiB new
9757105925b78de0fdc3be7115b114870d101154.js 4.4 KiB new
07816912cceddafd64f68cbf72485376f5c1ff3f.js 4.3 KiB new

Eager graph (modules shipped in each entrypoint's initial chunks)

Entrypoint Eager size Budget Modules
✅ app 11.15 MiB (+759.2 KiB / +7.1%) report-only 1106
Largest modules in the app closure
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 joethreepwood left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

edits

Co-authored-by: Joe Black <84011561+joethreepwood@users.noreply.github.com>
@joethreepwood joethreepwood self-assigned this Nov 16, 2026
@joethreepwood
joethreepwood marked this pull request as ready for review November 16, 2026 15:54
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

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Improvements or additions to product documentation, "Docs"

Projects

Status: New

Development

Successfully merging this pull request may close these issues.

1 participant