Fixed the ‘new customers’ widget query

Author: lukeholder

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release Notes for Craft Commerce
 
+## Unreleased
+
+- Fixed a bug where the "New Customers" stat was counting all customers with orders in the date range, rather than only customers whose first order was in the date range.
+
 ## 5.5.1 - 2025-12-04
 
 - Added `craft\commerce\models\CatalogPricingRule::afterPreparePurchasableQuery()`.

src/stats/NewCustomers.php

@@ -8,10 +8,13 @@
 namespace craft\commerce\stats;
 
 use craft\commerce\base\Stat;
+use craft\commerce\db\Table;
+use craft\db\Query;
+use craft\helpers\Db;
 use yii\db\Expression;
 
 /**
- * Total Orders Stat
+ * New Customers Stat
  *
  * @author Pixel & Tonic, Inc. <[email protected]>
  * @since 3.0
@@ -29,7 +32,18 @@ class NewCustomers extends Stat
     public function getData(): string|int|bool|null
     {
         $query = $this->_createStatQuery();
-        $query->select([new Expression('COUNT(DISTINCT [[customerId]]) as newCustomers')]);
+
+        // Subquery to find customers who have orders before the start date
+        $existingCustomersQuery = (new Query())
+            ->select(['customerId'])
+            ->from(Table::ORDERS)
+            ->where(['isCompleted' => true])
+            ->andWhere(['not', ['customerId' => null]])
+            ->andWhere(['<', 'dateOrdered', Db::prepareDateForDb($this->getStartDate())]);
+
+        $query->select([new Expression('COUNT(DISTINCT [[customerId]]) as newCustomers')])
+            ->andWhere(['not', ['customerId' => null]])
+            ->andWhere(['not in', 'customerId', $existingCustomersQuery]);
 
         return $query->scalar();
     }