Follow these steps to install, activate, and access the Sales By Country report in WooCommerce Analytics.
How to Install the Plugin
- Download the plugin ZIP file from the Subscriptions tab in your zorem.com account.
- In your WordPress admin, navigate to Plugins → Add New.
- Click Upload Plugin, select the downloaded ZIP file, and click Install Now.
- Click Activate Plugin after installation completes.
How to Activate the License
A valid license is required to use the plugin. To activate it:
- From your WordPress Dashboard, go to Plugins → Installed Plugins and find Sales Report By Country in the list.
- Click the Activate License link in the plugin’s row, beneath the plugin name alongside Deactivate. You will be redirected to zorem.com.
- Log in to your zorem account and authorize the connection to your store.
- You will be redirected back to your store and the license will be active. The Sales by Country report is now ready to use.
The plugin is listed in WordPress as Sales Report By Country — that is the same product as Sales By Country for WooCommerce, which is the name used on zorem.com and throughout this documentation.
If your store is on a staging domain, behind a firewall, or otherwise cannot reach zorem.com, the redirect-based activation will not complete. Contact zorem support and we will activate the licence against your domain manually.
Accessing the Report
Once installed and licensed, go to Analytics → Sales by Country in your WordPress admin.
Viewing the report requires the view_woocommerce_reports or manage_woocommerce capability — in practice, an Administrator or Shop manager. The per-order detail and the AI panels additionally require manage_woocommerce.
Import Your Existing Orders
Do this before you judge the report. The plugin records each order’s country as the order is placed, so orders that existed before you installed it have no country data yet and will not appear. A new installation therefore opens to an empty or near-empty report until you run the one-time import described in Past Order Import.
Configuration
The report needs no configuration to work. The plugin adds one settings screen at WooCommerce → Settings → Sales by Country, used to enable the optional AI features and store your API key — if you are not using them, you can ignore it entirely. See Setup and Configuration.
Requirements
| Requirement | Minimum Version | Tested Up To |
|---|---|---|
| WordPress | 5.6 | 7.1 |
| WooCommerce | 5.0 | 11.0.1 |
| PHP | 7.2 | — |
| WooCommerce Analytics | Enabled (included with WooCommerce) | — |
Troubleshooting
| Problem | What to check |
|---|---|
| No Sales by Country item under Analytics | WooCommerce Analytics must be enabled — check WooCommerce → Settings → Advanced → Features. Then confirm the plugin is active and the licence activated. |
| The report opens but is empty | Almost always because historical orders have not been imported yet. See Past Order Import. Also check that the selected date range actually contains orders. |
| "Sorry, you are not allowed to access this page" | The user lacks view_woocommerce_reports and manage_woocommerce. Assign the Administrator or Shop manager role. |
| Licence activation does not complete | The store cannot reach zorem.com — common on staging or firewalled sites. Contact support for manual activation. |
| Only recent orders have a country | New orders are recorded automatically; older ones need the import. Re-run it if you have since restored a backup or rebuilt the Analytics tables. |