Skip to content

docs(product-analytics): subscriptions are now free-tier#16994

Open
vdekrijger wants to merge 2 commits into
masterfrom
subscriptions-free-tier-docs
Open

docs(product-analytics): subscriptions are now free-tier#16994
vdekrijger wants to merge 2 commits into
masterfrom
subscriptions-free-tier-docs

Conversation

@vdekrijger
Copy link
Copy Markdown
Contributor

@vdekrijger vdekrijger commented May 22, 2026

Problem

Insight & dashboard subscriptions are moving to the free tier (PostHog/posthog#59624, PostHog/billing#1922). The docs still listed subscriptions as unavailable on the free plan — and once marked available, the <FeatureAvailability> widget would render the free tier as a plain checkmark, implying it's unlimited when the free plan is actually capped at 5 subscriptions.

Changes

  • Set availability.subscriptions.free so the free plan shows subscriptions as included.
  • Teach the <FeatureAvailability> widget to render a per-tier caveat string inline (e.g. Up to 5) instead of only a boolean check/x icon, so a limited tier no longer reads as unlimited. Existing boolean consumers (sso.mdx, funnels.mdx) are unchanged.
  • Set the free tier to Up to 5 in subscriptions.mdx. The free column now reads "Up to 5"; paid tiers keep their checkmarks.

The previous prose note ("the free plan includes up to 5 subscriptions") was dropped since the widget now carries that information directly.

Preview: https://2e9fedc5.posthog-preview.pages.dev/docs/product-analytics/subscriptions

CleanShot 2026-05-27 at 12 41 12

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

Set availability free: true and note the free-plan limit (5). Pairs with
PostHog/posthog#59624 and PostHog/billing#1922.
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 22, 2026

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview May 27, 2026 10:34AM

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 22, 2026

Vale prose linter → found 1 errors, 4 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/product-analytics/subscriptions.mdx — 1 errors, 4 warnings, 0 suggestions
Line Severity Message Rule
17:66 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
19:66 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
25:66 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
27:66 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
136:23 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

The FeatureAvailability widget rendered every tier as a boolean check/x
icon, so the free tier read as fully (unlimited) included when free
subscriptions are actually capped at 5. Widen each tier to accept an
inline caveat string and render it as text instead of an icon, then set
the free tier to 'Up to 5'. Existing boolean consumers are unchanged.
@vdekrijger vdekrijger marked this pull request as ready for review May 27, 2026 10:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant