The running count of registered customers in your Ecwid store.
At a glance
The total number of registered customers Ecwid holds for your store, as a live count. Ecwid permits guest checkout, so this is not the same as “everyone who ever bought from you”; it is the subset who have an account on the store. For an embedded-widget store running on WordPress, Wix, or Webflow, this is your addressable, contactable audience for re-engagement.
| What it counts | COUNT(customers) registered in the Ecwid store, as a real-time total. Guests who checked out without creating an account are not registered customers and are not counted here. |
| API endpoint | GET /v3/{store-id}/customers (paged, max 100 per call, OAuth2 with read_customers scope). Webhook updates fire on customer.created, customer.updated, customer.deleted. |
| What “customer” includes | Any customer record with an account in the store, regardless of whether they have placed an order yet. A signup with zero orders still counts. |
| What it excludes | Guest-checkout buyers with no account; deleted customer records; staff and admin accounts. |
| Deduplication | One record per customer email in Ecwid. A buyer who used the same email across multiple orders is a single customer. |
| Currency | Not applicable; this is a count. |
| Time window | RT (real-time running total, not a windowed figure). |
| Alert trigger | None - informational. |
| Roles | owner, marketing. |
Calculation
Calculated automatically from your Ecwid 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 small US candle maker running an Ecwid widget on a Wix site, snapshot taken 14 May 26. The merchant started the store 14 months ago and sells hand-poured candles and wax melts as a side business. Guest checkout is enabled because the merchant did not want to force account creation on first-time buyers.| Metric | Value (14 May 26) | 30 days prior | Change |
|---|---|---|---|
| Total Customers (this card) | 412 | 388 | +24 |
| Total orders (lifetime) | 1,140 | 1,062 | +78 |
| Orders from registered customers | 690 | 642 | +48 |
| Orders from guests | 450 | 420 | +30 |
Sibling cards merchants should reference together
| Card | Why it matters next to Total Customers | What the combination tells you |
|---|---|---|
| New Customers | The inflow. | Total flat + new customers rising = churn or guest checkout absorbing the growth. |
| Guest vs Registered Order Split | The reachability gap. | High guest share explains why customer count lags order count. |
| Repeat Customer Rate | Retention. | Big customer base + low repeat rate = a leaky bucket; acquisition is not sticking. |
| Repeat Purchase Rate | Order-level loyalty. | Confirms whether registered customers actually buy again. |
| High-Value Customers Unengaged on Email | The valuable slice at risk. | Identifies which of your registered customers are worth re-engaging first. |
| Total Orders | The activity denominator. | Orders per customer = a rough loyalty ratio. |
| Total Revenue | The value behind the people. | Revenue per registered customer is a quick lifetime-value proxy. |
Reconciling against Ecwid
Where to look in Ecwid’s own dashboard:
Ecwid Control Panel (my.ecwid.com) -> My Sales -> Customers
The customer list header shows the total count; filter and search refine it.
For a quick sanity check, the Customers page total should sit within a handful of records of our count.
Why our number may differ from Ecwid’s Control Panel:
| Reason | Direction | Why |
|---|---|---|
| Guest buyers | Either | Ecwid sometimes surfaces guest “contacts” in customer views; we count only registered accounts. |
| Deleted records | Theirs higher briefly | A just-deleted customer may linger in a cached view; we reflect the deletion on the next sync. |
| Merged duplicates | Ours lower | If two records share an email, we treat them as one customer; some Ecwid views list both. |
| Sync lag | Ours occasionally lower | Webhook-driven; the most recent signups may not be in for a few minutes. |
| Staff accounts | Theirs higher | Admin and staff logins are excluded from our count. |
ecwid_total_customers = COUNT(registered customer records, deduplicated by email)
Known limitations / merchant FAQs
Why is this lower than my total order count? Two reasons. First, repeat customers place many orders but count once. Second, Ecwid permits guest checkout, so buyers without an account never become registered customers. The gap between orders and customers is a mix of loyalty (good) and unreachable guests (a missed contact opportunity). Does a customer with zero orders count? Yes. Anyone with a registered account counts, even if they signed up and never bought. This is why your customer count can exceed the number of people who have actually purchased. Why does my Ecwid Control Panel show a different number? Usually guest-contact handling or sync lag. Ecwid sometimes lists guest buyers as contacts in customer views; we count only registered accounts. If after checking that the gap is more than a handful of records, raise a sync issue. How do I grow this number? Encourage account creation without forcing it. A soft prompt at order confirmation (“save your details for next time”) converts guests to registered customers without adding checkout friction. Capturing email at checkout, even for guests, also helps your reachable list. Is this the same as my email subscriber list? No. A registered customer has a store account; an email subscriber has opted in to marketing. The two overlap but are not identical. A customer can have an account without consenting to marketing, and a subscriber can exist without ever buying. A customer deleted their account. Does the count drop? Yes, on the next sync. Ecwid fires acustomer.deleted webhook and we remove the record. Customers can request deletion under privacy regulations, and the count reflects that.
Does this update in real time?
It is a real-time running total, refreshed as customer.created, customer.updated, and customer.deleted webhooks arrive. Expect new signups to appear within a few minutes.
I run two Ecwid stores for two currencies. Do customers combine?
No. Each Ecwid store has its own customer table. A buyer who has an account in your US store and your UK store is two customers across two stores. The card reports per store.