[luke-belton]

Changes

Adds a docs page for Supabase auth emails in Workflows: /docs/workflows/supabase-auth-emails.
It documents the feature that shipped in PostHog/posthog#123966, PostHog/posthog#123968 and PostHog/posthog#124168.

• The page covers setup across PostHog and Supabase, template rules, starter templates, template variables, turning on the hook, the card statuses, disconnecting, and troubleshooting.
• It explains why to send through PostHog: Supabase's built-in mailer sends 2 emails an hour, only to Supabase team members. Both claims link to Supabase's docs.
• It adds a step to raise Supabase's email rate limit, which Supabase checks before it calls PostHog.
• It says Connected only means the connection is saved, because PostHog can't see whether the hook is on.
• Supabase and PostHog get a step each: add the hook in Supabase, then save the connection in PostHog.
• A closing "Set it up over MCP" section gives an example prompt and the three tool names, like the Replay Vision page.
• The Workflows MCP page (surfaces/mcp.mdx) lists the Supabase tools.
• It adds the page to the Workflows sidebar under Channels, with a Beta badge.
• The feature is behind the workflows-supabase-auth-emails feature flag. The page opens with a "Private beta" callout, matching the Business Knowledge page.
• No screenshots yet.

Labels, buttons, statuses and error messages match PostHog master.

Open questions for review

• Beta convention: other private beta pages are listed in the nav with a callout, so this one is too. Remove the nav entry if it should stay unlisted until release.

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 Vercel preview build
• If I moved a page, I added a redirect in vercel.json (no pages moved)

🤖 Generated with Claude Code

[github-actions]

Deploy preview

Status	Details	Updated (UTC)
🟢 Ready	View preview	Nov 11, 2026 11:22AM

Changed pages

Page	Source
Send Supabase auth emails with PostHog	contents/docs/workflows/supabase-auth-emails.mdx
Use Workflows over PostHog MCP	contents/docs/workflows/surfaces/mcp.mdx

[github-actions]

Vale prose linter → found 0 errors, 9 warnings, 7 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/workflows/supabase-auth-emails.mdx — 0 errors, 5 warnings, 7 suggestions

Line	Severity	Message	Rule
8:171	warning	Capitalize 'Workflows' for PostHog's product. Use 'workflows' for the general industry concept.	PostHogBase.ProductNames
23:3	warning	'Reauthentication' is a possible misspelling.	PostHogBase.Spelling
43:20	warning	Capitalize 'Workflows' for PostHog's product. Use 'workflows' for the general industry concept.	PostHogBase.ProductNames
96:149	warning	'reauthentication' is a possible misspelling.	PostHogBase.Spelling
97:47	suggestion	Address the reader directly. Use 'you' instead of 'the user'.	PostHogDocs.DirectAddress
99:56	suggestion	Address the reader directly. Use 'you' instead of 'the user'.	PostHogDocs.DirectAddress
100:29	suggestion	Address the reader directly. Use 'you' instead of 'The user'.	PostHogDocs.DirectAddress
102:37	suggestion	Address the reader directly. Use 'you' instead of 'The user'.	PostHogDocs.DirectAddress
141:48	suggestion	Address the reader directly. Use 'you' instead of 'the user'.	PostHogDocs.DirectAddress
141:203	suggestion	Address the reader directly. Use 'you' instead of 'the user'.	PostHogDocs.DirectAddress
145:224	suggestion	Address the reader directly. Use 'you' instead of 'the user'.	PostHogDocs.DirectAddress
146:49	warning	Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept.	PostHogBase.ProductNames

contents/docs/workflows/surfaces/mcp.mdx — 0 errors, 4 warnings, 0 suggestions

Line	Severity	Message	Rule
7:226	warning	Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept.	PostHogBase.ProductNames
18:21	warning	Capitalize 'Workflows' for PostHog's product. Use 'workflows' for the general industry concept.	PostHogBase.ProductNames
20:64	warning	Capitalize 'Workflows' for PostHog's product. Use 'workflows' for the general industry concept.	PostHogBase.ProductNames
24:100	warning	Capitalize 'Workflows' for PostHog's product. Use 'workflows' for the general industry concept.	PostHogBase.ProductNames

[posthog]

PostHog Review · Standard · reviewed 3695504: 3 Should fix.

This is the only automatic review while this pull request is a draft. Comment @posthog review to review new changes sooner. Otherwise, a review of the new changes runs when you mark it ready for review.

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.

[github-actions]

Bundle report

Total JS (gzip)

12.06 MiB (+0.0 KiB / +0.0%)

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

Entrypoint	Eager size	Budget	Modules
✅ app	10.41 MiB (+0.2 KiB / +0.0%)	report-only	1100

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	1021.7 KiB
./src/components/Stickers/Stickers.tsx	696.4 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/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 + 59 modules	259.3 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/useProducts.tsx + 23 modules	153.9 KiB
./src/hooks/skills.tsx + 2 modules	150.7 KiB
./src/hooks/useProduct.ts + 9 modules	149.8 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).

[mayteio]

Why not have this up top? Short paragraph to make the user's life easier 😄