Glossary
Definitions for SubscriptionMonitor feature terms, metrics, and Stripe billing signals.
Use this glossary as a reference for the terms used across SubscriptionMonitor’s Dashboard, Retention, Account Explorer, Forecasting, and Alerts features.
Revenue metrics
Section titled “Revenue metrics”For how these metrics are calculated from your Stripe data, see the Revenue Dashboard.
| Term | Definition |
|---|---|
| MRR | Monthly Recurring Revenue. The normalized monthly value of active subscriptions. Annual plans are divided by 12, and other billing intervals are converted to a monthly equivalent. Current MRR is net of permanent recurring discounts and, when enabled in Reporting Defaults, active repeating discounts. One-time discounts do not affect MRR. |
| Normalized MRR | MRR converted to a common monthly basis across billing intervals and, where applicable, the workspace base currency. |
| CMRR | Committed Monthly Recurring Revenue. Current MRR adjusted for scheduled changes already known in Stripe: subscriptions with cancel_at_period_end set, and scheduled upgrades or downgrades defined in subscription_schedules. See CMRR and committed changes. |
| ARR | Annual Recurring Revenue. Current MRR multiplied by 12. |
| ARPA | Average Recurring Revenue per Account. Total MRR divided by active paying accounts. |
| NRR | Net Revenue Retention. Of the opening MRR from a cohort of existing paying accounts at the start of the period, the percentage retained at period end after expansion, contraction, and churn. MRR is measured from active recurring subscriptions (annual normalized to monthly; subscriptions in trialing or paused status are excluded). Values above 100% mean expansion outweighed losses. |
| GRR | Gross Revenue Retention. The same opening-MRR base as NRR, retained after contraction and churn but excluding expansion. GRR is capped at 100%. |
| MRR growth rate | The percentage change in MRR over a reporting period, commonly month over month or year over year. |
| Quick Ratio | Growth efficiency ratio: (New + Expansion + Reactivation MRR) ÷ (Contraction + Churned MRR) for the period. The components are the same subscription-change movements shown in the MRR movements waterfall. |
| Net New MRR | Net MRR movement in a period: New MRR plus Expansion MRR plus Reactivation MRR minus Contraction MRR and Churned MRR. |
| New MRR | MRR from first-time paying accounts in the reporting period. |
| Expansion MRR | Additional MRR from existing accounts that upgraded, added subscription items, increased quantity, or moved to a higher priced plan. |
| Contraction MRR | MRR lost from existing accounts that downgraded, removed subscription items, reduced quantity, or moved to a lower priced plan. |
| Churned MRR | MRR lost when accounts cancel or otherwise leave active paid subscription status. |
| Reactivation MRR | MRR recovered when a previously churned account becomes active and paying again. |
| Delinquent revenue | MRR attached to subscriptions or invoices in failed payment states such as past_due or unpaid. |
| Revenue concentration | The share of total MRR represented by the largest accounts, such as the top 10 accounts. |
| Top-account breakdown | A list of the largest accounts contributing to revenue concentration for the selected reporting period. |
| Non-recurring revenue | Paid one-time invoice-line revenue reported separately from recurring MRR, ARR, waterfall, retention, and forecast calculations. |
| Active recurring item | A recurring subscription item that is active for the selected reporting period. |
| MRR band / ARR band | A filter range that groups accounts by recurring revenue size. |
| Base currency | The reporting currency used when SubscriptionMonitor normalizes revenue from multiple Stripe currencies. |
| Recurring discount | A Stripe discount with forever or repeating duration that applies to subscription revenue. Permanent discounts are always reflected in current recurring metrics; active repeating discounts are reflected when the workspace setting is enabled. |
| Reporting Defaults | Settings for the workspace base currency, normalized top-level metrics, recurring-discount treatment, and weekly digest delivery. The recurring-discount setting is shared by test and live modes. |
| Methodology transition | A reporting-definition change, such as recurring-discount treatment, that refreshes current metrics without being reported as customer expansion, contraction, churn, or reactivation. Historical invoice-based metrics are not restated. |
| FX impact | The difference between selected-month foreign-currency movement translated at current normalized values and movement-date FX rates. |
Trial conversion
Section titled “Trial conversion”For how trials are tracked and valued from Stripe, see Conversion.
| Term | Definition |
|---|---|
| Trial Conversion | The Conversion page metric showing reporting-month trial starts that converted to active paid subscriptions. |
| Active trial | A subscription currently in Stripe trialing status. |
| Converted trial | A trial that moved from trialing to active paid status in the reporting month. |
| Canceled trial | A trial subscription canceled before a paid conversion was observed. |
| Trial value | Projected MRR for a trial based on stored subscription item prices, normalized to the workspace base currency. |
Retention and account health
Section titled “Retention and account health”For how these signals are derived from Stripe subscriptions and invoices, see Retention.
| Term | Definition |
|---|---|
| Customer churn rate | The percentage of paying accounts lost in a reporting period. |
| Revenue churn rate | The percentage of opening MRR lost to cancellations and contraction in a reporting period. |
| Opening MRR | The MRR from a set of accounts at the start of a reporting period, used as the denominator for retention and churn calculations. |
| Cohort | A group of accounts that share a starting event, usually the month their first Stripe subscription was created. |
| Revenue cohort retention | The percentage of a cohort’s original recurring revenue that remains after 1, 3, 6, 12, or more months. |
| Customer cohort retention | The percentage of accounts in a cohort that remain active after a given number of months. |
| Trial conversion rate | The percentage of accounts that move from Stripe trialing status to active paid status. |
| Renewal-at-risk | An account with a Stripe signal that could threaten future revenue, such as cancel_at_period_end, failed renewal payment, scheduled downgrade, or a high-value renewal coming soon. |
| Renewal exposure | The amount of ARR or MRR tied to upcoming renewals that may need attention. |
| Recently churned account | An account that cancelled or left active paid subscription status in the current or recent reporting period. |
| Churn reason tag | A manual or seeded annotation that explains why the latest churn event happened, optionally with a note. |
| Win-back outreach | Follow-up with churned or at-risk accounts to recover revenue or prevent cancellation. |
| Tenure | How long an account has been active as a paying subscriber. |
| Delinquency status | Whether an account has failed payments, unpaid invoices, or other billing collection issues. |
Forecasting and quantity analysis
Section titled “Forecasting and quantity analysis”For how these projections are built from Stripe billing data, see Forecasting.
| Term | Definition |
|---|---|
| MRR forecast | A forward projection of MRR over future windows such as 3, 6, or 12 months. |
| Cohort-based projection | A forecast that uses observed revenue retention from existing cohorts to estimate future revenue. |
| Renewal Wall | A view of upcoming renewals weighted by ARR, useful for spotting concentrated renewal risk. |
| Scenario modeling | Adjusting assumptions such as churn, contraction, or expansion to compare upside and downside revenue outcomes. |
| Baseline forecast | The default projection based on current subscription trends and observed historical data. |
| Billing interval | How often a subscription is billed, such as monthly, quarterly, or annually. |
| Billing cycle anchor | Stripe’s timestamp that determines when a subscription’s billing period renews. |
| Subscription schedule | A Stripe object that defines planned future subscription changes, such as upgrades, downgrades, or phase changes. |
| Proration event | A Stripe billing adjustment created when a subscription changes mid-cycle. |
| Quantity-driven pricing | Pricing where subscription revenue depends on billed quantity, such as seats, licenses, or units. |
| Licensed quantity | The billed quantity attached to a subscription item, often representing seats or licenses. |
| Quantity expansion | An increase in billed quantity for an existing account. |
| Quantity contraction | A decrease in billed quantity for an existing account. |
| Quantity lens / quantity layer | A supporting Dashboard or Forecasting view that shows whether revenue movement came from billed quantity changes, price changes, or both. |
| Billed quantity band | A filter range that groups accounts by the number of billed units, seats, or licenses. |
Alerts and digest
Section titled “Alerts and digest”For how these alert conditions are evaluated and delivered, see Alerts and Digest.
| Term | Definition |
|---|---|
| Alert threshold | A configured value that determines when an alert fires, such as a churn percentage or minimum MRR loss. |
| Churn spike | An alert condition where customer churn rate or churned MRR exceeds the configured threshold. |
| MRR contraction alert | An alert condition where net MRR movement goes negative or contraction exceeds the configured threshold. |
| Payment failure cluster | An alert condition where more than a configured percentage of subscriptions have failed payments within a selected window. |
| Large renewal approaching | An alert condition for a high-value annual renewal coming within a selected time window. |
| Licensed quantity drop | An alert condition where a top account materially reduces billed quantity. |
| Revenue concentration threshold | An alert condition where the top accounts represent more than the configured share of recurring revenue. |
| Weekly digest | A scheduled email summary of current MRR, net new MRR, churned MRR, top expansions, top contractions, upcoming renewals, and fired alert rules. |
| CSV export | A downloadable comma-separated file containing the currently filtered view from Dashboard, Retention, Account Explorer, Account Detail, Forecasting, or Alerts. |