Customer KPI widget

The Customer KPI widget is the mirror image of the Order KPI widget — it lives above the Shopware customer list (Customers → Overview) and shows four customer-side metrics with value, Δ % against the previous period and a sparkline.

Eight customer KPIs are available; you pick which four are visible.

What you see

Above the customer list, before the filter bar:

• A date-range picker with the same 9 presets and custom calendar as the rest of the plugin.
• Four KPI cards with current value, Δ % and sparkline.
• An exclude-today toggle.
• An order states filter so the customer counts only include people whose orders match (e.g. customers with at least one paid order, not just abandoned carts).

Available metrics

Metric	Definition
New customers	Customers whose first order falls in the range
Returning customers	Customers who had an earlier order and also ordered in the range
Active customers	Customers with at least one order in the range
Orders per customer	Total orders / active customers
Average customer revenue	Total revenue / active customers
Guest orders	Orders without a registered customer account
Retention rate	Share of previous-period customers who also ordered in the current period
Registration conversion rate	Share of guest orders converted into registered customers

The full definitions are in KPI list → Customers.

Configuration

Settings live under Settings → Plugins → P2Lab Stats → Widgets → Customers.

Setting	What it controls
Enabled	Show or hide the widget
Default period	Preset used on first page load
Exclude today	When on, the range ends yesterday so a partial day doesn’t skew the comparison
Default order states	Limit the calculation to customers whose orders match these states
Visible metrics	Pick 4 of the 8 metrics

Tips & gotchas

Tip

For B2B-heavy shops, swap Guest orders out of the visible four — guests are rare. Use Returning customers + Retention rate instead to track account stickiness.

Note

Retention rate in this widget is computed against the previous range of equal length. For week-over-week numbers, pick “last 7 days”; for month-over-month, pick “last 30 days” or “current month”.

Caution

New customers counts the customer’s first order date, not their account creation date. Customers who registered earlier but only ordered now count as new in this metric. Choose Registration conversion rate if you want to track registration timing instead.

Related

• Order KPI widget
• Customer reports — the deeper analyses (RFM, cohort, overview)
• KPI list — every metric, defined
• Configuration → Widgets — full settings reference