Docs Sales By Country for WooCommerce

Sales By Country for WooCommerce

The Sales By Country for WooCommerce plugin integrates directly into WooCommerce Analytics, giving store owners a dedicated country-level sales report. Filter by date range, toggle between billing and shipping country, see every country together in one chart, and — when filtering by a single country — drill into a detailed Orders table and a Best-Selling Products by Country table.

Since version 1.6.8 the plugin also includes an optional set of AI features — a written summary of the period, ranked recommendations, a plain-language question box, and country anomaly alerts that run entirely on your own server.

New here? Install and open the report with Getting Started, then run Past Order Import so your existing orders appear. If a figure ever looks wrong, How the Numbers Are Calculated explains every column.

Plugin Features

Country-Level Sales Report

Full WooCommerce Analytics report showing orders, items sold, total sales, net sales, tax and average order value broken down by country.

Billing & Shipping Toggle

Switch between billing country and shipping country views with a single click.

Orders Table (Single Country)

When filtering by a single country, view a full Orders table with date, order #, status, customer, products, items sold, coupons, net sales, and attribution.

Best-Selling Products by Country

When filtering by a single country, see a product breakdown with qty sold, total sales, net sales, orders, and avg price.

Date, Country & Currency Filtering

Apply any WooCommerce Analytics date range, narrow to specific countries, and on a multi-currency store choose which currency to report in.

Optional AI Insights

Bring your own Anthropic, OpenAI or Google API key for a written summary of the period, ranked country recommendations, and a question box. Anomaly alerts need no key at all.

Download Reports

Export any report table as a CSV download directly from the Analytics interface.

The report itself needs no configuration — once installed and licensed, go to Analytics → Sales by Country and it is ready. 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 the AI features you can ignore it entirely.
Orders placed before you installed the plugin will not appear until you run a one-time import. This is the most common first-run surprise. See Past Order Import.

Getting Started

Install Sales By Country for WooCommerce, activate your licence, open the report in WooCommerce Analytics, and import your existing orders so they appear.

Setup and Configuration

The Sales by Country settings screen at WooCommerce → Settings → Sales by Country, field by field, plus the controls available on the report itself.

Reports & Filters

The views, columns and filters in the Sales by Country report — the main country table, the billing/shipping toggle, date, country, currency and language filters, the AI panels, and CSV export.

How the Numbers Are Calculated

Exactly which orders the Sales by Country report counts, how every column is calculated, how refunds and missing countries are handled, and why a figure may differ from core WooCommerce Analytics.

Single Country View

Filtering to exactly one country reveals an Orders table and a Best-Selling Products by Country table — what every column means, how refunds appear, and the row limits.

AI Features

Optional AI features in Sales By Country — insight summaries, recommendations, natural-language Q&A, and on-server country anomaly alerts. Added in version 1.6.8.

Compatibility

Requirements, and how Sales By Country works with multi-currency and multilingual plugins — CURCY, WPML, Aelia, Yay Currency, WooCommerce Multi-Currency and Price Based on Country.

Past Order Import

Orders placed before the plugin was installed have no country data. Run WooCommerce's Import Historical Data with "Skip previously imported" unchecked to backfill them.

Changelog

Version history and release notes for Sales By Country for WooCommerce, from 1.0 in December 2021 to 1.6.8 in August 2026.