Skip to content

docs(data-warehouse): explain person-property keys - #22374

Open
jakesciotto wants to merge 1 commit into
masterfrom
explain-person-property-keys
Open

jakesciotto wants to merge 1 commit into
masterfrom
explain-person-property-keys

Conversation

@jakesciotto

@jakesciotto jakesciotto commented Nov 15, 2026 •

Copy link
Copy Markdown
Contributor

Changes

Explain how to use warehouse data keyed by a person property, such as customer_id. Add a materialized-view example that joins to persons and resolves one distinct ID per person.

Correct the outdated restriction on materialized views. Document duplicate keys, unmatched rows, full refresh, and the older scheduling limitation. Only the warehouse properties docs page changes.

Verified current backend matching, source validation, picker behavior, and view-sync tests through the GitHub API. Materialized-view support shipped in PostHog/posthog#83850. The live report has no linked implementation, and none of the 267 open PRs changes this page.

Validation

  • Ran Prettier and pnpm format:docs. Preserved availability frontmatter indentation.

  • Markdown lint, MDX compilation, YAML checks, internal links and heading anchors, and git diff --check pass.

  • Vale reports no errors or new findings. Nine warnings predate this change.

  • pnpm check:source-release-callouts and pnpm check:posthog-js-defaults pass.

  • SQL join fixtures pass for multiple distinct IDs, shared customer IDs, unmatched people, missing identities, and null or empty keys. Fixtures use SQLite with equivalent JSON access. Live HogQL schema checks pass; runtime validation returned a proxy HTTP 502.

  • Attempted pnpm start twice. Raised the shell file limit after an EMFILE failure. The retry completed page queries but did not serve the client bundle during the six-minute attempt. Stopped the local preview. Deployed preview validation is recorded below.

  • All 22 CI checks pass on 2aabf795aef53b870d3c2e23dfb5e53030ee2912.

  • Opened the deployed changed page in Chromium (HTTP 200). Checked the rendered new section, SQL example, and setup instructions.

  • Compared the browser console with the production page. SVG width errors and React errors Burger menu color fix #418/Small fixes for pricing and free trial pages #423 occur on both. The preview also returns 404 for /docs/data-warehouse/warehouse-properties.md; its HTML page renders correctly. Live HogQL execution remains unverified after the proxy HTTP 502 recorded above.

Context

Report: https://us.posthog.com/project/2/inbox/01a1d68a-e648-7f6b-a5bc-7a1594720468

Parent Talyn thread: 33c6e75a-e9b8-4871-81ed-cc5f94ec77e1

Source Talyn session: 756db23e-b3c4-40a8-b7fb-2dd6ea6fe803

Review /docs/data-warehouse/warehouse-properties in the PR preview.

Checklist

  • I've read the docs and/or content style guides.
  • Words are spelled using American English
  • Use relative URLs for internal links
  • I've checked the pages added or changed in the deployed PR preview build (Cloudflare Pages)
  • No pages moved or renamed. No redirects are required.

View this session in Talyn

@github-actions github-actions Bot added docs Improvements or additions to product documentation, "Docs" content PR only touches files under contents/ labels Nov 15, 2026
@github-actions

github-actions Bot commented Nov 15, 2026 •

Copy link
Copy Markdown
Contributor

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Nov 15, 2026 08:24PM

Changed pages

Page Source
Warehouse properties contents/docs/data-warehouse/warehouse-properties.mdx

@github-actions

Copy link
Copy Markdown
Contributor

Vale prose linter → found 0 errors, 9 warnings, 0 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/data-warehouse/warehouse-properties.mdx — 0 errors, 9 warnings, 0 suggestions
Line Severity Message Rule
16:164 warning Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. PostHogBase.ProductNames
16:205 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
16:261 warning Capitalize 'Surveys' for PostHog's product. Use 'surveys' for the general industry concept. PostHogBase.ProductNames
26:3 warning Capitalize 'Feature Flags' for PostHog's product. Use 'Feature flags' for the general industry concept. PostHogBase.ProductNames
26:21 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
30:86 warning Capitalize 'Feature Flags' for PostHog's product. Use 'Feature flags' for the general industry concept. PostHogBase.ProductNames
30:104 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
166:65 warning 'resends' is a possible misspelling. PostHogBase.Spelling
176:104 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. PostHogBase.ProductNames

@jakesciotto jakesciotto self-assigned this Nov 15, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Bundle report

Total JS (gzip)

12.22 MiB (no change)

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

Entrypoint Eager size Budget Modules
✅ app 11.15 MiB (no change) 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).

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

content PR only touches files under contents/ docs Improvements or additions to product documentation, "Docs"

Projects

Status: New

Development

Successfully merging this pull request may close these issues.

1 participant