Follow these steps to install the plugin, run the one-time import, and open the subscription reports in WooCommerce Analytics.
Requirements
| Requirement | Minimum version | Tested up to |
|---|---|---|
| WordPress | 5.3 | 7.1 |
| WooCommerce | 7.0 | 11.0.1 |
| PHP | 7.2 | — |
| WooCommerce Subscriptions | Installed and active — any current version | — |
| WooCommerce Analytics | Enabled (included with WooCommerce) | — |
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
- 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:
| Card | Fields | Needed for |
|---|---|---|
| Import Historical Subscription Data | Date range (All / 365 / 90 / 30 / 7 days / 24 hours / Custom, with From and To dates), Start Import, Repair Last 30 Days, Delete Previously Imported Data | Required once. All historical figures, and the Revenue Recognition tab, depend on this |
| Cancellation feedback | Show the question after cancelling; Group answers with AI. Both off by default, with a Collected so far count | The Cancellations tab stays empty until the first is on |
| AI Insights | Enable AI Insights, AI provider, API key, Model, Test connection. Off by default | The optional written summaries on Overview, Upcoming Revenue and Cancellations |
Troubleshooting
| Problem | What to check |
|---|---|
| No Subscription Report item under Analytics | WooCommerce Analytics must be enabled under WooCommerce → Settings → Advanced → Features, and both WooCommerce and WooCommerce Subscriptions must be active. |
| No Analytics menu at all | WooCommerce Analytics is switched off, or your user lacks manage_woocommerce. |
| An admin notice says a dependency is missing | WooCommerce or WooCommerce Subscriptions is not installed or not active. The plugin deliberately does nothing until both are present. |
| Every report is empty | Run the historical import. This is the expected state on a fresh install. |
| The reports load but a colleague sees nothing | They need the manage_woocommerce capability — Administrator or Shop manager. |
| Figures look wrong rather than missing | Start with Metric Definitions — several metrics have deliberate scopes that surprise people, particularly MRR excluding trials. |