Title: CodeFaeries Top Customers Author: Long Watch Studio - Code Faeries Published: 09 June 2026 Last modified: 05 October 2026 --- Search plugins ![](https://ps.w.org/codefaeries-top-customers/assets/banner-772x250.png?rev=3565628) ![](https://ps.w.org/codefaeries-top-customers/assets/icon-256x256.png?rev=3565628) # CodeFaeries Top Customers De [Long Watch Studio – Code Faeries](https://profiles.wordpress.org/lwsdevelopers/) [Download](https://downloads.wordpress.org/plugin/codefaeries-top-customers.1.0.8.zip) * [Details](https://lij.wordpress.org/plugins/codefaeries-top-customers/#description) * [Reviews](https://lij.wordpress.org/plugins/codefaeries-top-customers/#reviews) * [Installation](https://lij.wordpress.org/plugins/codefaeries-top-customers/#installation) * [Development](https://lij.wordpress.org/plugins/codefaeries-top-customers/#developers) [Supòrto](https://wordpress.org/support/plugin/codefaeries-top-customers/) ## Description CodeFaeries Top Customers adds a dedicated page under **WooCommerce Top Customers** that ranks your shoppers so you can spot the customers who matter most at a glance. **Highlights** * Sortable ranking table — customer name, revenue, order count, average cart, frequency, and customer since * Summary cards — totals and per-customer averages for any date range * Segment pills — At-Risk, New, VIP, Regular, One-Time (priority-evaluated) * Charts — Top-10 revenue bar chart and revenue concentration doughnut * Customer detail panel — recent orders, top products, profile link * Ignore and restore customers — keep staff, test or wholesale accounts out of the ranking * Date-range presets + custom range * Live search, column visibility toggles, and CSV export * HPOS-ready (automatic detection of High-Performance Order Storage) * Active-subscriber awareness (WooCommerce Subscriptions optional) * GDPR personal-data exporter and eraser, with anonymized customers reported as a single aggregate row **Only completed and processing orders are counted.** Pending, on-hold, cancelled, refunded, and failed orders are excluded from rankings and totals. **Top Customers Pro** is a separate add-on that builds on this plugin with advanced customer segmentation, lifecycle analysis, RFM scoring, automated email campaigns, and custom scheduled reports. This free plugin is complete on its own and never expires. ### Privacy & Data All customer ranking data is computed locally from your own WooCommerce database. The plugin does not contact any external service: no data ever leaves your site. Customer avatars are drawn locally from name initials, so no requests are made to third-party avatar providers. ## Installation WooCommerce 7.0 or later is required; activation is refused below that version. 1. Upload the plugin files to `/wp-content/plugins/codefaeries-top-customers`, or install it directly from the WordPress admin interface. 2. Activate the plugin through the **Plugins** menu. 3. Visit **WooCommerce Top Customers**. ## FAQ-e ### My totals differ from the WooCommerce sales report. Top Customers only counts orders in the Completed or Processing status. Small differences from core reports are expected. ### Are guest orders included? Yes. Guests are grouped by billing email. Customers without a billing email cannot be ranked. ### Does it handle multiple currencies? No. Revenue is reported in your store’s base currency without conversion. ### What happens on uninstall? If “Delete all plugin data when uninstalling” is enabled on the Top Customers page, all options and transients created by the plugin are removed. Otherwise, your settings are preserved so you can reinstall later. The plugin creates no database table and schedules no cron job. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “CodeFaeries Top Customers” is open source software. The following people have contributed to this plugin. Contributors * [ Long Watch Studio – Code Faeries ](https://profiles.wordpress.org/lwsdevelopers/) [Translate “CodeFaeries Top Customers” into your language.](https://translate.wordpress.org/projects/wp-plugins/codefaeries-top-customers) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/codefaeries-top-customers/), check out the [SVN repository](https://plugins.svn.wordpress.org/codefaeries-top-customers/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/codefaeries-top-customers/) by [RSS](https://plugins.trac.wordpress.org/log/codefaeries-top-customers/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.8 – 2026-10-05 * Fixed: amounts and dates in the customer table and its charts follow your WordPress language instead of your browser’s. * Fixed: the RFM Score column separates the score from the segment name. * Fixed: the help tab’s support link leads to the contact page. * Fixed: on a site that also runs a CodeFaeries Pro plugin, this plugin’s bundled toolkit can no longer take the place of the Pro’s and cause a critical error. * Improved: an add-on can leave part of an order’s total out of customer revenue, which Top Customers Pro uses to exclude products, categories and payment methods. * Improved: the bundled admin toolkit is updated to its latest release. * Compatibility: tested up to WordPress 7.1. #### 1.0.5 – 2026-06-19 * Improved: usage tracking has been removed entirely from the free plugin — it no longer collects any data or contacts external services. * Improved: the contextual help tab and readme now state clearly that the plugin makes no outbound network requests — all processing stays on your site. * Improved: simplified the admin navigation by removing the locked Pro teaser tabs. * Improved: updated the bundled charting library to Chart.js 4.5.1. #### 1.0.4 – 2026-05-18 * Improved: customer avatars are now drawn locally from name initials — the plugin no longer contacts any external avatar service. * Improved: documentation now lists the opt-in telemetry service the plugin can contact. * Improved: distribution package hardened for the WordPress.org Plugin Directory. #### 1.0.3 – 2026-05-11 * Compatibility: minimum PHP requirement stated as 7.4, which is what the plugin has always needed. * Code quality: passes WordPress Plugin Check cleanly. #### 1.0.2 * Fixed: removed repeated “Invalid plugin file” errors that WooCommerce logged on every admin request when the plugin runs alongside its Pro add-on. #### 1.0.1 * Fixed: database queries hardened and graceful handling when optional dependencies are missing. * Fixed: stability fixes at plugin startup — internal services now initialize reliably alongside the shared toolkit. * Fixed: correct loading when the plugin runs alongside its Pro add-on. #### 1.0.0 First public release. CodeFaeries Top Customers ranks your WooCommerce customers by revenue, order count, and other lifetime metrics. * Customer ranking dashboard with sortable columns and visual charts. * Customer segments (top spenders, frequent buyers, and more). * CSV export of the customer list. * GDPR data exporter and eraser. * Opt-in anonymized telemetry. * HPOS and legacy order-table support. ## Mêta * Version **1.0.8** * Last updated **8 minutes ago** * Active installations **Fewer than 10** * WordPress version ** 6.0 or higher ** * Tested up to **7.1.2** * PHP version ** 7.4 or higher ** * Language * [English (US)](https://wordpress.org/plugins/codefaeries-top-customers/) * Tags * [analytics](https://lij.wordpress.org/plugins/tags/analytics/)[csv](https://lij.wordpress.org/plugins/tags/csv/) [customers](https://lij.wordpress.org/plugins/tags/customers/)[reports](https://lij.wordpress.org/plugins/tags/reports/) [woocommerce](https://lij.wordpress.org/plugins/tags/woocommerce/) * [Advanced View](https://lij.wordpress.org/plugins/codefaeries-top-customers/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/codefaeries-top-customers/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/codefaeries-top-customers/reviews/) ## Contributors * [ Long Watch Studio – Code Faeries ](https://profiles.wordpress.org/lwsdevelopers/) ## Supòrto Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/codefaeries-top-customers/)