Docs Analytics for WooCommerce Subscriptions Getting Started

Getting Started

Follow these steps to install the plugin, run the one-time import, and open the subscription reports in WooCommerce Analytics.

Requirements

RequirementMinimum version
WordPress5.3 or higher
WooCommerce7.0 or higher
WooCommerce SubscriptionsInstalled and active
PHP7.2 or higher
WooCommerce AnalyticsEnabled (included with WooCommerce)
Both WooCommerce and WooCommerce Subscriptions are required. If either is missing the plugin does nothing and shows an admin notice until it is installed.

Installing the plugin

  • Download the plugin ZIP file from your account.
  • In your WordPress admin, go to Plugins → Add New.
  • Click Upload Plugin, select the ZIP file, and click Install Now.
  • Click Activate Plugin when the installation finishes.

Run the historical import

Right after activation the reports will be empty. The plugin builds its own daily aggregation table so reports stay fast on large stores, and that table has to be filled in from your existing subscriptions once.

  • Go to WooCommerce → Settings → Subscription Analytics.
  • Under Import Historical Subscription Data, choose a date range (use All the first time).
  • Click Start Import and leave the page open until the progress bar completes.
You only need to do this once. After the import, new signups, renewals, switches and cancellations are tracked automatically. See Importing Historical Data for the full details.

Opening the reports

Go to WooCommerce → Analytics → Subscription Report. The report opens on the Overview tab, with the other reports available as tabs across the top:

  • Overview — MRR, ARR, active subscribers and the headline health metrics.
  • Over Time — signups, renewals and cancellations across the date range.
  • Products — the same metrics broken down per subscription product.
  • Variations — broken down per individual variation.
  • Upcoming Revenue — scheduled renewals and the collection forecast.
  • Customers — subscriber counts and average lifetime value.
  • Acquisition — which campaigns and sources produce paying subscribers.
  • Churn Risk — every open subscription scored from 0 to 100.
  • Cancellations — why customers leave, grouped into themes.
  • Revenue Recognition — cash received versus revenue earned, and the deferred balance.

Every tab uses the standard WooCommerce Analytics date-range picker at the top of the screen, and each one remembers its own chart type and interval while you move between tabs.

Settings

The reports themselves need no configuration. The only settings screen is WooCommerce → Settings → Subscription Analytics, which holds three things: the historical data importer, the optional AI Insights configuration, and the optional cancellation feedback question. All AI and feedback options are off by default.