docs: Add warning that email attachments are temporarily unavailable by inkeep[bot] · Pull Request #22032 · PostHog/posthog.com

inkeep · 2026-11-06T15:02:31Z

Changes

This PR adds warning callouts to the transactional email documentation noting that the attachments field is temporarily unavailable. This reflects the changes in PostHog/posthog#130952, which disables email attachments until files are moved to object storage.

Files updated:

contents/docs/workflows/transactional-emails/api.mdx
- Added a CalloutBox warning at the start of the "Copies and attachments" section
- Warns users that requests with attachments will receive a 400 error
contents/docs/workflows/transactional-emails/examples.mdx
- Added a CalloutBox warning to the "Receipt with a PDF" example
- Clarifies that this example will not work until attachments are re-enabled
contents/docs/workflows/transactional-emails/index.mdx
- Updated the comparison table row for "Copies and attachments"
- Notes that cc and bcc remain available, but attachments are temporarily unavailable
- Links to the API page for more details

Context

Related PR: fix(cdp): refuse email attachments until they leave the cyclotron database posthog#130952
Reason: Email attachment files were being stored in the Cyclotron Postgres database. Until they're moved to object storage (tracked in feat(workflows): keep email attachments up to 10 MB in object storage posthog#130794), the API temporarily refuses requests that include attachments.
Behavior: Requests with attachments return a 400 error. Sends without attachments work normally.
Temporary: Attachments will be re-enabled once the object storage migration is complete.

This PR was created by the Inkeep Content Writer agent, which is maintained by the Docs and Wizard team. Please reach out on Slack for help if needed.

…ily unavailable PR PostHog/posthog#130952 temporarily disables the `attachments` field, returning a 400 error. Add a CalloutBox warning to the Receipt with a PDF example so readers know the example won't work until attachments are re-enabled.

github-actions · 2026-11-06T15:02:43Z

Deploy preview

Status	Details	Updated (UTC)
🟢 Ready	View preview	Nov 09, 2026 05:15AM

Changed pages

Page	Source
Send transactional emails	`contents/docs/workflows/transactional-emails/index.mdx`
Send transactional emails with the API	`contents/docs/workflows/transactional-emails/api.mdx`
Transactional email examples	`contents/docs/workflows/transactional-emails/examples.mdx`

github-actions · 2026-11-06T15:03:32Z

Vale prose linter → found 34 errors, 1 warnings, 3 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/transactional-emails/api.mdx — 7 errors, 0 warnings, 0 suggestions

Line	Severity	Message	Rule
17:1	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`
18:1	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`
181:1	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`
182:1	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`
340:1	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`
341:1	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`
342:1	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/docs/workflows/transactional-emails/examples.mdx — 0 errors, 1 warnings, 3 suggestions

Line	Severity	Message	Rule
19:17	suggestion	Address the reader directly. Use 'you' instead of 'The user'.	`PostHogDocs.DirectAddress`
66:76	suggestion	Address the reader directly. Use 'you' instead of 'the user'.	`PostHogDocs.DirectAddress`
105:37	suggestion	Address the reader directly. Use 'you' instead of 'the user'.	`PostHogDocs.DirectAddress`
156:4	warning	'Receipt with a PDF' heading should be in sentence case, and product names should be capitalized.	`PostHogBase.SentenceCase`

contents/docs/workflows/transactional-emails/index.mdx — 27 errors, 0 warnings, 0 suggestions

Line	Severity	Message	Rule
113:1	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`
114:1	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`
115:1	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`
116:1	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`
133:1	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`
134:1	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`
135:1	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`
156:1	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`
157:1	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`
158:1	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`
159:1	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`
160:1	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`
186:1	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`
187:1	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`
188:1	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`
189:1	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`
253:42	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`
254:74	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`
255:42	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`
256:39	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`
257:35	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`
281:1	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`
282:1	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`
283:1	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`
284:1	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`
285:1	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`
286:1	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`

github-actions · 2026-11-06T15:16:45Z

Bundle report

Total JS (gzip)

11.72 MiB (+20.7 KiB / +0.2%)

Largest changed named chunks

Chunk	Gzip	Δ vs master
`d53be7e4323c811b7b208da3a1f00becabbdd275.js`	453.3 KiB	new
`96de664570b44467a6d0591760da6319c7a1ad80.js`	118.3 KiB	new
`5aa5ee945072e4f9d3d44bec70663734bdcce0e6.js`	60.9 KiB	new
`43af5110865685afc312d725bbc8b0fa06295ef4.js`	48.2 KiB	new
`e7657ff7b4d9f20436d43a02b14e1f3e008b9586.js`	24.1 KiB	new
`b3b57042f42a4c3df1852b62fc001e3975abcfe2.js`	16.3 KiB	new
`e0bc1239a903d67dbc6b2fa186972ca55bf47098.js`	12.7 KiB	new
`c398b08c5fd6725ed4539ebfc25732567896556b.js`	10.5 KiB	new
`39ca4d4373ed8be9d061c36928f73f9739f67d58.js`	7.7 KiB	new
`8bb6c6f0741a9dea82c1a5298bc23c69824903eb.js`	7.0 KiB	new
`03fab9b00f7efe583e1063371bd2b772f4153aac.js`	6.2 KiB	new
`82d263abb5852d2df6cd3b057db268d2a235285a.js`	5.2 KiB	new
`c90d25f57c4d21271dd5e4de053750c1158fe334.js`	4.3 KiB	new
`177609198ba68da49069d791a929a1c196c544dd.js`	4.0 KiB	new
`component---src-pages-learn-error-tracking-agent-prompts-and-mcp-tsx.js`	3.9 KiB	new

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

Entrypoint	Eager size	Budget	Modules
✅ `app`	9.94 MiB (+2.3 KiB / +0.0%)	report-only	1023

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`	839.8 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.1 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`	150.0 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).

github-actions · 2026-11-06T15:18:42Z

Hey @meikelmosby! This docs PR was generated for you by an agent. You're responsible for reviewing and merging it into production.

Review and approve the PR
Merge the PR
a. Check the preview env and CI build and merge it yourself
b. Enable auto-merge if you're confident in the changes

Revert the table and code reformatting that came with the notes, and state the error a send with attachments gets: a 400 with the code invalid_request and attr attachments. cc and bcc are unchanged. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Silthus

Checked against PostHog/posthog#130952: a code send with attachments gets a 400 (invalid_request, attr attachments), cc and bcc unchanged. Reverted the unrelated reformat.

github-actions · 2026-11-09T05:15:55Z

Hey @meikelmosby! This docs PR was generated for you by an agent. You're responsible for reviewing and merging it into production.

Review and approve the PR
Merge the PR
a. Check the preview env and CI build and merge it yourself
b. Enable auto-merge if you're confident in the changes

inkeep Bot added 3 commits November 6, 2026 15:00

docs: add warning about temporarily unavailable email attachments

6694b00

docs: note that email attachments are temporarily unavailable

3e7d09f

inkeep Bot requested a review from meikelmosby November 6, 2026 15:02

github-project-automation Bot added this to PostHog.com planning Nov 6, 2026

github-project-automation Bot moved this to New in PostHog.com planning Nov 6, 2026

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

Silthus approved these changes Nov 9, 2026

View reviewed changes

Silthus enabled auto-merge (squash) November 9, 2026 04:57

Silthus merged commit 9307e92 into master Nov 9, 2026
23 checks passed

Silthus deleted the docs-writer-ai-update-2026-11-06T15-00-07-883Z-x99zlm branch November 9, 2026 05:17

github-project-automation Bot moved this from New to Done in PostHog.com planning Nov 9, 2026

This was referenced Nov 9, 2026

docs(workflows): attach files to emails by upload, then send #22022

Merged

docs(workflows): send React Email components through PostHog #21984

Merged

Navigation Menu

Repository navigation

docs: Add warning that email attachments are temporarily unavailable - #22032

docs: Add warning that email attachments are temporarily unavailable#22032
Silthus merged 4 commits into
masterfrom
docs-writer-ai-update-2026-11-06T15-00-07-883Z-x99zlm

inkeep Bot commented Nov 6, 2026

Uh oh!

github-actions Bot commented Nov 6, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Nov 6, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Nov 6, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Nov 6, 2026

Uh oh!

Silthus left a comment

Uh oh!

github-actions Bot commented Nov 9, 2026

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

inkeep Bot commented Nov 6, 2026

Changes

Files updated:

Context

Uh oh!

github-actions Bot commented Nov 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Deploy preview

Changed pages

Uh oh!

github-actions Bot commented Nov 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Nov 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Bundle report

Total JS (gzip)

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

Uh oh!

github-actions Bot commented Nov 6, 2026

Uh oh!

Silthus left a comment

Choose a reason for hiding this comment

Uh oh!

github-actions Bot commented Nov 9, 2026

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

github-actions Bot commented Nov 6, 2026 •

edited

Loading

github-actions Bot commented Nov 6, 2026 •

edited

Loading

github-actions Bot commented Nov 6, 2026 •

edited

Loading