Getting Started

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

Requirements

RequirementMinimum versionTested up to
WordPress5.37.1
WooCommerce7.011.0.1
PHP7.2—
WooCommerce SubscriptionsInstalled and active — any current version—
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. Works with both HPOS and legacy post-based order storage.

You need the manage_woocommerce capability — an Administrator or Shop manager — to see the reports or the settings screen. There is no lower-privilege view.

Installing the plugin

  • Download the plugin ZIP from the Subscriptions tab of your zorem.com 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 every report is empty, and that is expected. 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 let the progress bar run.

You only need to do this once. After the import, new signups, renewals, switches and cancellations are tracked automatically. See Importing Historical Data for what to do if it stalls.

Opening the reports

Go to WooCommerce → Analytics → Subscription Report. The report opens on the Overview tab, with the others 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 and Variations — the same metrics broken down per subscription product, and 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. For the formula behind any figure, see Metric Definitions.

Settings

There is one settings screen, at WooCommerce → Settings → Subscription Analytics. It holds three cards:

CardFieldsNeeded for
Import Historical Subscription DataDate range (All / 365 / 90 / 30 / 7 days / 24 hours / Custom, with From and To dates), Start Import, Repair Last 30 Days, Delete Previously Imported DataRequired once. All historical figures, and the Revenue Recognition tab, depend on this
Cancellation feedbackShow the question after cancelling; Group answers with AI. Both off by default, with a Collected so far countThe Cancellations tab stays empty until the first is on
AI InsightsEnable AI Insights, AI provider, API key, Model, Test connection. Off by defaultThe optional written summaries on Overview, Upcoming Revenue and Cancellations
Most of the reports need no configuration at all — install, import once, and they work. The two exceptions are worth knowing: Revenue Recognition shows zeros until the importer has run, and the Cancellations tab shows nothing until you switch on the feedback question. Everything AI-related is optional and off until you add your own API key.

Troubleshooting

ProblemWhat to check
No Subscription Report item under AnalyticsWooCommerce Analytics must be enabled under WooCommerce → Settings → Advanced → Features, and both WooCommerce and WooCommerce Subscriptions must be active.
No Analytics menu at allWooCommerce Analytics is switched off, or your user lacks manage_woocommerce.
An admin notice says a dependency is missingWooCommerce or WooCommerce Subscriptions is not installed or not active. The plugin deliberately does nothing until both are present.
Every report is emptyRun the historical import. This is the expected state on a fresh install.
The reports load but a colleague sees nothingThey need the manage_woocommerce capability — Administrator or Shop manager.
Figures look wrong rather than missingStart with Metric Definitions — several metrics have deliberate scopes that surprise people, particularly MRR excluding trials.