Sales with comparison, product funnel, RFM customer segments, cohorts and lifetime value, fast on large stores.
Available Updated Oct 24, 2026Version 1.0.0CS-Cart, Multi-Vendor 4.17.2 – 4.21.x No core file edits
Built for
Sales Reports Pro: overview1 of 16
What it does
The core sales reports show totals, not answers. Sales Reports Pro shows how sales develop against the previous period or the same period last year, which products sell and convert, who your best customers are and who is about to leave, how many customers come back and what a customer is worth over time. It counts only paid orders, counts a split Multi-Vendor checkout once and subtracts refunds. Made for store owners and marketplace operators who want reliable figures without an external analytics service.
How it works
After installation the add-on prepares its data from your orders and keeps it current automatically. Open Orders, Sales Reports Pro, choose a period and a comparison, and switch between overview, products, customers, cohorts, lifetime value and channels. Export any table as CSV, save a report with its filters and schedule e-mail digests. Product page views are counted after the page has loaded, compatible with the full page cache. On Multi-Vendor, filter by vendor or let vendors see their own reports.
Features
Sales overview with comparison: net and gross sales, refunds, orders, average order value, units, new customers
Charts by day, week or month with the comparison period
Product performance by product, category or vendor with return rate and margin
Product funnel: views, cart adds, orders and conversion
RFM customer segments with editable thresholds, CSV export and user group action
Monthly acquisition cohorts and customer lifetime value
Sales by marketing channel with Order Source & UTM Attribution
Saved reports and daily, weekly or monthly e-mail digests
Fast on large stores thanks to incremental snapshot tables
Vendor filter and optional vendor panel reports (Multi-Vendor)
What you get
Package
kv_sales_reports_pro-1.0.0.zip, installed through Add-ons → Manage add-ons
Updates & support
12 months included. Download new versions from your account and install them in Add-ons → Manage add-ons or the Upgrade Center.
License
1 production installation. Staging, dev and localhost are free and unlimited. The add-on keeps working after the update period ends. How licensing works
Compatibility
We list only the builds we install and test on. “Tested” means the full test plan was run on that build; “Supported” means the build is inside the supported range and uses the same hooks.
CS-Cart version and edition compatibility
CS-Cart version
CS-Cart
CS-Cart Ultimate
Multi-Vendor
Multi-Vendor Ultimate
4.22 and later
Testing next
Testing next
Testing next
Testing next
4.21.2
Supported
Supported
Supported
Supported
4.20.x
Supported
Supported
Supported
Supported
4.19.x
Supported
Supported
Supported
Supported
4.18.x
Supported
Supported
Supported
Supported
4.17.2
Tested
Supported
Tested
Supported
Before 4.17.2
Not supported
Not supported
Not supported
Not supported
Last tested build: Multi-Vendor 4.17.2, Oct 24, 2026Tested on: Multi-Vendor 4.17.2, CS-Cart 4.17.2
Requirements
Platform
CS-Cart or CS-Cart Multi-Vendor 4.17.2 – 4.21.x
PHP
PHP 7.2.5 – 8.3 (as supported by your CS-Cart version)
Platform
MySQL or MariaDB with InnoDB (standard on every CS-Cart host)
Requirement
Recommended for large stores and for e-mail digests: a cron job (see below)
Core changes
None. Hooks and template overrides only
1.0.0
Oct 24, 2026
Latest
Added 11
Sales overview with comparison (previous period or last year): net and gross sales, refunds, orders, average order value, units, customers and new customers; chart by day, week or month; breakdown and orders by status.
Counting rules: paid statuses ("Payment received" or chosen), Multi-Vendor checkouts counted once, refunds from RMA returns and refunded statuses.
Product performance by product, category or vendor with share, change, return rate, margin (Product Cost & Profit) and the product funnel (views, cart adds, orders) with a full-page-cache-safe view counter.
Customers: new vs. returning, RFM segments with editable thresholds, segment lists with CSV export and "add to user group", top customers.
Monthly acquisition cohorts (returning share, customers, net sales, cumulative value per customer).
Customer lifetime value: historical value, orders per customer, repeat rate, time between orders, value after 1, 3, 6 and 12 months.
Channels report with Order Source & UTM Attribution.
CSV export, saved reports (private or shared), daily/weekly/monthly e-mail digests.
Report snapshot tables with incremental sync (hooks, modification time, daily reconcile), cron dispatch.
Multi-Vendor: vendor filter; optional vendor panel access to the vendor's own reports.
License client with status card, self-healing upgrade synchronizer.
Tested on Multi-Vendor 4.17.2, CS-Cart 4.17.2. First release.
Why do the figures differ from the core sales reports?
The core reports count orders of the statuses configured in each report and count every vendor order of a Multi-Vendor checkout. Sales Reports Pro counts only the statuses marked "Payment received" (or the ones you choose), counts a split checkout once and subtracts refunds. The definitions are listed in Usage.
Which orders count?
Orders in the counted statuses (Paid and Complete by default). Open, failed, declined and canceled orders are shown in "Orders by status" but do not count in sales. Incomplete orders are ignored.
How are guests counted as customers?
By their e-mail address, ignoring upper and lower case. A guest who orders twice with the same address is one returning customer. Registered customers are counted by their account.
Why is the product revenue lower than gross sales?
Product revenue is item price x quantity minus the item's share of the order discount. Gross sales are order totals and include shipping and taxes added on top of the prices.
How are refunds counted?
From returns of the core RMA add-on (accepted items, in the return statuses of the settings) and from orders in a "refunded" status that you select in the settings. If RMA recalculates the order automatically, the returned items are added back to gross sales, so the refund is not subtracted twice.
Is the product view counter compatible with the full page cache?
Yes. Cached product pages are the same for every visitor; the count is sent by a small script after the page has loaded. Each product is counted once per browser session; staff and bots are skipped. Nothing is stored in the visitor's session.
How fast is it with many orders?
The reports read a prepared snapshot, not the core order tables. With 200,000 orders the first build took 35 seconds, and every report over a three-year period opened in under 2 seconds.
Can vendors see other vendors' data?
No. With vendor access on, every query of the vendor panel is limited to the vendor's own company, whatever the request contains. Customer e-mail addresses are hidden from vendors.
Are e-mails sent to customers when I add a segment to a user group?
No. The customers are added to the group silently. Use the group in a promotion, a usergroup price or your newsletter.
Which currency do the reports use?
The primary currency of the store, which CS-Cart uses to store order totals.
What happens if the license lapses?
Without a valid license (no key after the 14-day start period, an invalid or revoked key, a domain the license does not cover, or no successful check for 14 days), no new data is collected: the report snapshot, the product view counter and the e-mail digests stop. Reports and CSV exports of the data collected so far stay available. Once the license is valid again, the add-on catches up with the orders changed in the meantime.
The admin panel shows a license notice.
Open Add-ons → Manage add-ons → Sales Reports Pro → Settings → License. The status line says what is wrong: no key, a key for another add-on, a revoked license, or a domain that the license does not cover. Fix it and click Check now. See License.
Does the add-on work on my staging copy?
Yes. Subdomains of your licensed domain (for example staging.yourstore.com) and local development hosts (localhost, private IP addresses, .local, .test) are covered by the same license.
Does the license check slow down my storefront or checkout?
No. The check runs in the admin panel or from cron, once a day. The storefront never runs it.
Add a released add-on to this order and save 15% on it. It uses the same edition and store domain.
Sales Reports ProThis add-on
+
Order Source & UTM AttributionSee which channel, campaign and landing page brought every order, with revenue by channel.
$49
+
Vendor Analytics DashboardGive every vendor real sales, product, conversion and payout analytics, and compare all vendors side by side as the marketplace owner.
$99
+
Admin Activity Log & Audit TrailSee who changed which price, order, setting or add-on, with the old and new value of every field.
$49
Also from Kavio Labs
Available now and coming next, tested on the same CS-Cart builds.