Metric Definitions

Every number in the Subscription Report is defined here, with the formula it is actually calculated from. If a figure looks wrong, or two tabs disagree, start on this page.

MRR and ARR

Both come from a single annual run-rate. For every active subscription, the recurring total is converted to an annual figure according to its billing period, then divided by its billing interval:

A subscription billed every 3 months is therefore counted as total × 4 ÷ 1; one billed every 2 months as total × 12 ÷ 2.

• MRR = annual run-rate ÷ 12
• ARR = MRR × 12 — which is exactly the annual run-rate again

The annual run-rate is calculated first, so ARR and MRR can never drift apart by rounding.

Recurring totals are order totals, so they include tax and shipping where your store charges them.

Active Subscriptions — two definitions

This is intentional, but it means the two tabs will not match on a store with subscriptions awaiting cancellation.

The Customers report’s list is filterable by developers through wcs_reports_active_statuses, which receives array( 'active', 'pending-cancel' ).

Churn Rate (Last 30 Days)

A standard subscriber churn rate, measured against the base you started the window with:

• Numerator — subscriptions that moved to cancelled or expired within the last 30 days.
• Denominator — subscriptions that existed 30 days ago and had not already been cancelled or ended at that point.
• This is subscriber churn, not revenue churn. A cancelled $200/mo subscription and a cancelled $5/mo subscription count the same.
• The card always uses a rolling 30-day window and ignores the date-range picker.

Renewal Success Rate — two definitions

The Overview card and the Upcoming Revenue forecast both publish a renewal success rate, and they count differently. Expect them to differ on any store that has cancelled or pending renewal orders.

Net Subscription Growth

"Ended" means cancelled or expired within the period. The Over Time report describes the same figure as the net change in active subscriptions across the period — it is the same calculation, worded differently.

Lifetime Value

Per customer, lifetime value is the sum of their initial subscription order total plus all their renewal and switch order totals. These are order totals, so tax and shipping are included.

The Average Lifetime Value summary card is the customer-weighted mean of that figure across the customers included in the report under your current filters — not a store-wide, all-time average. Change the filters and the average changes with them.

Revenue Recognition

Recognition amortises each paid subscription order across the days of the period it covers. Full detail, including refunds, trials and the treatment of tax, is on Revenue Recognition and Deferred Revenue.

Which subscription and order statuses count

Churn Risk scores on-hold and pending-cancellation subscriptions because both are at risk of ending. The forecast excludes pending-cancellation because that revenue is not expected to arrive. This is why the two tabs can show different subscription counts for the same store.

Dates and time zones

Weeks start on Monday. The default date range when a report is first opened is the trailing 12 months.

Multi-currency stores

Who can see the reports

Every tab, and the settings screen, requires the manage_woocommerce capability — in practice an Administrator or Shop manager. There is no separate, lower-privilege view. If someone reports an empty report or a permissions error, this is the first thing to check.

Why a figure might not match WooCommerce’s own reports