Skip to content
For AI agents and documentation tools, use llms.txt for the documentation index. Full public content is available at llms-full.txt. Markdown versions of pages are available by appending .md to canonical URLs when published; the homepage Markdown is available at /index.md.
Features Retention Intelligence

Retention Intelligence

Churn rates, revenue cohort retention curves, renewal-at-risk signals, recently churned accounts, and churn reason breakdowns.

The Retention module shows where your subscription revenue is quietly leaking.

SubscriptionMonitor tracks two churn rates for each reporting period:

Customer churn rate — percentage of paying accounts lost in the period.
Revenue churn rate — percentage of opening MRR lost to contraction and cancellation.

Both are shown for the current month and as a trailing 12-month view.

The cohort grid is the flagship view. It shows what percentage of each signup cohort’s recurring revenue remains at 1, 3, 6, and 12 months. Cohort membership is assigned at the time a Stripe subscription is first created.

A secondary grid shows what percentage of each signup cohort is still active (not churned) at the same time intervals.

SubscriptionMonitor surfaces accounts with:

cancel_at_period_end enabled on their subscription.
Upcoming annual renewals within a configurable window.
Delinquent renewal attempts — failed payment on a renewal invoice.
Scheduled downgrades via subscription_schedules.

A ranked list of accounts that churned in the current or recent period, sorted by their prior MRR or ARR contribution. Each row can include a churn reason tag, prior quantity, and plan context. Use this to prioritize win-back outreach.

Retention rolls up churn reason tags across the same recently churned window. The breakdown shows prior normalized MRR, account count, and share by reason.

Churn reason tags are edited from Account Detail. SubscriptionMonitor stores the tag and optional note as an annotation on the latest churn event; it does not change Stripe data or recurring revenue facts.

For licensed or quantity-driven pricing, Retention also surfaces accounts where billed quantity has dropped even if the total revenue impact is small. A quantity contraction signal can be an early warning before a full cancellation.

Retention CSV exports include churn reason code, label, note, and update timestamp for recently churned rows.