Analytics

The Analytics screen surfaces the revenue and subscriber metrics that matter for a subscription business. Open it from Subscriptions → Analytics.

This page documents the metrics and views that actually ship with the core plugin. The Advanced Analytics add-on extends the set with additional reporting.

Date ranges

The plugin exposes five preset ranges (no custom date picker and no comparison-to-previous-period in the core):

  • Last 7 days
  • Last 30 days
  • Last 90 days
  • Last 12 months
  • This year

Revenue metrics

MRR (Monthly Recurring Revenue)

Normalized monthly revenue from active subscriptions, computed regardless of billing cadence (annual subscriptions are divided by 12, etc.). Returned by /analytics/overview and /analytics/revenue.

ARR

MRR × 12.

ARPU

Average revenue per user.

MRR movement

An MRR-movement view is present in the Analytics page. The core plugin exposes this as a separate panel; the specific components surfaced in that view (new, expansion, contraction, churned, reactivated) depend on the version you are running, and the Advanced Analytics add-on may extend them.

Subscriber metrics

  • Active subscribers: counted from subscriptions in the wc-active and wc-pending statuses.
  • New subscribers: subscriptions that started in the period.
  • Churned subscribers: subscriptions that moved to Cancelled in the period.
  • Reactivated subscribers: subscriptions that moved back to Active from On-hold in the period.

Retention

A cohort retention view groups subscribers by signup month and shows how many remain active N months later. Driven by /analytics/cohorts.

LTV is provided by /analytics/ltv.

Breakdowns

The core plugin ships one breakdown: per product (via /analytics/products). Other breakdowns (by country, gateway, plan, tag, category) are not provided by the core plugin.

Upcoming revenue

The /analytics/upcoming-revenue endpoint returns a projection of renewals in the near future.

Events

The /analytics/events endpoint returns a log of subscription events for the period.

Charts

Analytics charts are interactive (hover to see values). The core plugin does not include zoom, double-click reset, PNG export, or a CSV-export button.

Refresh cadence

Analytics is computed in real time from your live subscription data on each request. No caching layer is exposed in the UI; there is no “Analytics cache” setting and no “Rebuild analytics” tool.

Data integrity

Metrics depend on clean subscription data:

  • Subscriptions stuck in Pending inflate active counts if left unresolved.
  • Subscriptions without a linked customer can distort LTV and per-customer metrics.
  • Duplicate subscriptions from a botched migration distort every metric; see Migration.

Extending with the add-on

The Advanced Analytics add-on adds deeper reporting (for example, richer MRR-movement decomposition and additional dashboards). Install it from Subscriptions → Add-ons if you need the extended metrics.

Troubleshooting

Numbers do not match my gateway dashboard

Differences are usually from refunds (subtracted in Analytics), partial refunds (proportionally subtracted), and currency conversion rounding.

A subscription is missing from totals

Check its status. Active-subscriber metrics count only wc-active and wc-pending.

Charts look slow on a large store

Narrow the date range, or install the Advanced Analytics add-on for larger-scale reporting.

Next steps