AI Insights Summary for Sales by Country

The AI Insights Summary sits at the top of the Sales by Country report and describes the selected period in plain language — the totals, which countries are driving them, and anything that stands out. It is written from the same figures shown in the chart and table below it.

Where to find it

Analytics → Sales by Country — the panel appears above the chart once AI is enabled and a key is saved.

Seeing the summary requires the manage_woocommerce capability — an Administrator or Shop manager.

What it covers

Total and net sales, order count and average order value for the period.
The countries contributing most of the revenue.
How the period compares with the previous one of the same length.
Anything worth a second look — for example a country with plenty of orders but an unusually low average order value.

What a summary looks like

The exact wording differs every time, because it is generated from your own figures. A summary for a 30-day period typically reads something like this:

Sales totalled £48,210 across 612 orders in the last 30 days, up 14% on the previous 30 days, with an average order value of £78.77. The United Kingdom, Germany and France account for just over three quarters of revenue. Germany grew fastest, up 31% on the previous period. Sweden is worth a look: 44 orders, but an average order value of £41 — barely half the store average.

The summary always reflects the filters you have applied. Change the date range, switch between billing and shipping country, or select a currency, and a summary for that exact view is produced.

Caching and cost

Summaries are cached for 24 hours. Revisiting the same view reuses the stored summary instead of calling your provider again, so browsing the report repeatedly does not repeatedly bill you. Cached summaries are kept in your own database for 90 days and then deleted automatically.

A cached summary is matched on the date range, country type (billing or shipping), currency, provider and model. Change any of those and a new summary is generated.

The country and language filters are not part of the cache match. If you narrow the report to specific countries — or switch WPML language — while keeping the same date range, currency, provider and model, the panel will show the summary that was already generated for that period rather than one written for your narrowed selection. Use Refresh to generate a summary for what is actually on screen.

Use the Refresh control on the panel to force a new summary before the cache expires — for example after importing historical orders, or after a rebuild in WooCommerce Analytics.

Each summary is a small request — roughly the size of a short email — so typical usage costs a fraction of a cent per generated summary. Refresh generates a new summary and therefore costs the same as the first one, so it is not free, just very cheap. The exact figure depends on the provider and model you choose.

If the summary does not appear

What you see	Why	What to do
No panel at all	AI features are switched off, no API key is saved, or your user lacks `manage_woocommerce`.	Enable AI and save a key under WooCommerce → Settings → Sales by Country, and check the user’s role.
There are no sales in this period to summarise	The selected date range contains no orders with country data.	Widen the date range, or run Past Order Import so past orders carry country information.
An error from the provider	The key was rejected, or the account is out of credit or quota.	Use Test connection on the settings screen to confirm the key still works.
The panel spins and then fails	Your server could not reach the provider, or the request timed out after 45 seconds.	See the connection troubleshooting in Setting Up AI.
The summary describes figures that no longer match the table	You are seeing a cached summary — most likely because you changed the country or language filter. Click Refresh.
The summary is in the wrong language	Summaries are written in the language the model infers from the request. Ask for a different language using Ask a Question, or choose a model with stronger multilingual support.