Skip to content

docs(workflows): clarify suppression list behavior for transactional vs marketing email - #21747

Open
inkeep[bot] wants to merge 1 commit into
masterfrom
docs-writer-ai-update-2026-10-29T16-31-17-294Z-a2k79v
Open

inkeep[bot] wants to merge 1 commit into
masterfrom
docs-writer-ai-update-2026-10-29T16-31-17-294Z-a2k79v

Conversation

@inkeep

@inkeep inkeep Bot commented Oct 29, 2026

Copy link
Copy Markdown
Contributor

Changes

Updates the suppression list documentation in contents/docs/workflows/opt-outs.mdx to reflect the behavior change from PR PostHog/posthog#124638.

What changed

Before: The docs stated that suppression is "category-independent" and that "a suppressed recipient receives nothing."

After: The docs now explain that suppression blocking behavior depends on message type:

  • Marketing email is blocked by all suppressions (hard bounces, soft bounces, spam complaints, and manual entries)
  • Transactional email (password resets, invoices, login codes) is only blocked by hard bounces, because that means the address can't receive mail at all

This matches the new behavior where transactional workflow emails are sent unless the address has hard-bounced, ensuring critical messages like password resets reach recipients who may be on the suppression list for other reasons.

Related


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.

…mail

Reflects PostHog/posthog#124638 – transactional email (password resets,
invoices, login codes) now sends through soft bounces, spam complaints,
and manual suppression entries. Only a hard bounce blocks it. Marketing
email is unchanged: every suppression still blocks it.
@inkeep
inkeep Bot requested a review from meikelmosby October 29, 2026 16:32
@github-actions github-actions Bot added docs Improvements or additions to product documentation, "Docs" content PR only touches files under contents/ labels Oct 29, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Vale prose linter → found 0 errors, 1 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/workflows/opt-outs.mdx — 0 errors, 1 warnings, 0 suggestions
Line Severity Message Rule
44:16 warning 'suppressions' is a possible misspelling. PostHogBase.Spelling

@github-actions

github-actions Bot commented Oct 29, 2026 •

Copy link
Copy Markdown
Contributor

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Oct 29, 2026 04:53PM

Changed pages

Page Source
Opt-outs and suppression contents/docs/workflows/opt-outs.mdx

@github-actions

Copy link
Copy Markdown
Contributor

Bundle report

Total JS (gzip)

10.53 MiB (no change)

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

Entrypoint Eager size Budget Modules
✅ app 20.39 MiB (no change) report-only 2113
Largest modules in the app closure
Module Size
./src/data/mcp-tools.json 1458.7 KiB
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 840.9 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/x-ray.mjs 481.2 KiB
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/trenchcoat.mjs 450.8 KiB
./node_modules/.pnpm/rehype-raw@7.0.0/node_modules/rehype-raw/lib/index.js + 29 modules 395.1 KiB
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/im-the-driver.mjs 385.8 KiB
./src/hooks/useCustomers.tsx + 61 modules 381.8 KiB
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/tourist.mjs 364.6 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
./src/components/ProductComparisonTable/index.tsx + 130 modules 314.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/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/doll-house.mjs 284.1 KiB
./node_modules/.pnpm/cloudinary-core@2.14.0_lodash@4.17.21/node_modules/cloudinary-core/cloudinary-core.js 281.9 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

Copy link
Copy Markdown
Contributor

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

  1. Review and approve the PR
  2. 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

@github-actions

Copy link
Copy Markdown
Contributor

This PR hasn't seen activity in two weeks! Should it be merged, closed, or further worked on? If you want to keep it open, please remove the stale label – otherwise this will be closed in another week. If you want to permanently keep it open, use the waiting label.

@github-actions github-actions Bot added the stale This pull request has been marked as stale and will be closed soon automatically label Nov 13, 2026

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" stale This pull request has been marked as stale and will be closed soon automatically

Projects

Status: Planned

Development

Successfully merging this pull request may close these issues.

0 participants