Total Customers for the selected period.
At a glance
The total customer count for your store. On WooCommerce this number carries a genuine ambiguity that surprises most merchants: WC’s native customer object counts registered accounts only, while a large share of Woo stores allow guest checkout, where the buyer leaves a billing email but never creates an account. Depending on how the count is defined, those guests may or may not be included. This card reads the WooCommerce customer endpoint and is explicit about which definition it uses so the number means what you think it means.
Calculation
Calculated automatically from your WooCommerce data. See the At a glance summary above for what the metric tracks and the worked example below for a typical reading.Worked example
A self-hosted WooCommerce store on WC 9.0 with guest checkout enabled. Snapshot taken 14 Jun 26.
Four things to notice:
- The card’s “Total Customers” is 8,420, but ~13,000 people have actually bought from this store. That gap is the registered-versus-guest nuance in one line. The native WC customer count (8,420) includes 2,270 accounts that never purchased and excludes 4,310 distinct guests who did. Know which population your card reports before you compare it to anything.
- Registered does not mean buyer. 2,270 of the 8,420 accounts have never placed an order, perhaps they registered for a newsletter or abandoned at checkout. If you want “customers who have bought”, that is a different, smaller number than the raw account count.
- Guest emails need deduplication. 4,900 guest orders resolve to 4,310 distinct emails: some guests bought more than once, some used slightly different names. Without email dedup, a guest-inclusive count over-states unique buyers. WC does not merge guest history into a later-created account automatically.
- There is no alert on this card by design. Total Customers is a cumulative real-time figure that only grows; a threshold alert would be meaningless. Watch movement through New Customers and Customer Churn instead, which are the directional cards.
Sibling cards merchants should reference together
Reconciling against WooCommerce
Where to look in WordPress / WooCommerce Admin: WP Admin → WooCommerce → Customers (the WC Analytics customers report) is the closest first-party view. Note that the WC Analytics customers report can include guests that have placed orders, whereas WP Admin → Users filtered to the Customer role shows registered accounts only. The gap between those two screens is precisely the registered-versus-guest nuance this card calls out. Other WP Admin views that touch the same data:- WP Admin → Users (role: Customer): registered customer accounts only. Matches a registered-only definition.
- WP Admin → Analytics → Customers (WC 4.0+): can include guest buyers and offers filters for new versus returning, the richest first-party breakdown.
- WooCommerce → Orders: the source of guest billing emails; a manual unique-email count here approximates the guest population.
Known limitations / merchant FAQs
Does this count guest customers or only registered accounts? This is the single most important question on WooCommerce, and the honest answer is that it depends on the definition the card uses. WC’s native customer object (wc/v3/customers) returns registered accounts only. Guest buyers leave a billing email on the order but never create an account, so they are a separate population entirely. The card states which population it counts. If your store relies on guest checkout, do not assume “Total Customers” means everyone who has ever bought from you.
Why is this number higher than the count of people who have actually bought?
Because registered accounts include people who created an account but never placed an order, newsletter sign-ups, abandoned-checkout registrations, or accounts created during a failed first purchase. The “customers who have bought” figure is a smaller subset. If you need buyers specifically, use the WC Analytics customers report filtered to those with at least one order.
Why does my WooCommerce → Customers report show a different number?
The WC Analytics customers report can include guest buyers, while WP Admin → Users filtered to the Customer role shows registered accounts only. If the card uses a registered-only definition, it will match Users but not Analytics. Decide which population you care about and compare against the matching screen.
Can the same person be counted twice?
Yes, on guest-heavy stores. A guest who buys, then later registers, creates two records that WooCommerce does not automatically merge. The same email used with two different names at checkout can also double-count unless deduplicated. Treat the count as approximate at the edges if your store leans on guest checkout.
Why is there no alert on this card?
Total Customers is a cumulative figure that only ever grows, so a fixed threshold would not carry meaning. The directional signals you want alerts on are growth and loss: watch New Customers for acquisition pace and Customer Churn for retention.
How fresh is the count?
It is a real-time figure refreshed on the standard sync, typically hourly on a self-hosted store. A customer who registered moments ago may take until the next poll to appear. Because the total is cumulative and large, a single new record will not change the headline materially.