CodeFaeries Top Customers ranks your WooCommerce customers so you can spot your best customers at a glance. It adds a dedicated page under WooCommerce > Top Customers with a customer ranking by revenue, order count, average cart, purchase frequency and customer age.
Which customers bring the most revenue? Who is a VIP, who is new, who is at risk of leaving? This WooCommerce customer report answers from your own orders, for any date range, with customer segments, charts and a CSV export.
Free customer ranking features for WooCommerce
Rank your top customers
- 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
- Date-range presets and custom range
- Live search and column visibility toggles
- Guest orders included - Guests are grouped by billing email
Customer segments and charts
- Segment pills - At-Risk, New, VIP, Regular and One-Time customers, with live counts
- Top 10 revenue bar chart - Your ten top customers by revenue
- Revenue concentration doughnut chart
- Customer detail panel - Recent orders, top products and profile link
See the customer where you work
- Customer summary on orders - A Top Customers box on the WooCommerce order screen shows the customer's segment, revenue, order count, average cart and customer since
- Segment in the users list - A Segment column in the WordPress users list, linked to the customer ranking
- Acquisition source - The customer detail panel shows how the first order was attributed by WooCommerce order attribution
Keep the ranking clean and export it
- Ignore and restore customers - Keep staff, test or wholesale accounts out of the customer ranking
- CSV export of the customer list
- Only completed and processing orders are counted - Pending, on-hold, cancelled, refunded and failed orders are excluded from rankings and totals
Built for WooCommerce
- HPOS-ready - Automatic detection of WooCommerce High-Performance Order Storage
- WooCommerce Subscriptions aware - Active subscribers are flagged (WooCommerce Subscriptions optional)
- GDPR personal-data exporter and eraser, with anonymized customers reported as a single aggregate row
- No database table, no cron job created by the plugin
Your customer data stays on your site
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.
Top Customers Pro
Top Customers Pro is a separate add-on that builds on this plugin with RFM scoring and Customer Lifetime Value estimation, custom segmentation rules, a customer lifecycle page with a cohort retention grid and churn-risk scoring, custom reports with optional scheduled email delivery, and automated email campaigns. This free plugin is complete on its own and never expires.
Do you like Top Customers?
A review on
wordpress.org helps other store owners find it:
leave a review. Thank you.
WooCommerce 7.0 or later is required; activation is refused below that version.
- Upload the plugin files to
/wp-content/plugins/codefaeries-top-customers, or install it directly from the WordPress admin interface.
- Activate the plugin through the Plugins menu.
- Visit WooCommerce → Top Customers.
1.1.0 - 2026-11-20
- New: a Top Customers box on the WooCommerce order screen shows the customer's segment, revenue, order count, average cart and customer since.
- New: a Segment column in the WordPress users list, linked to the customer ranking.
- New: the customer detail panel shows the acquisition source of the first order, read from WooCommerce order attribution.
1.0.11 - 2026-11-20
- Improved: the plugin's WordPress.org page says what the plugin does in the words store owners search for, with a longer FAQ.
1.0.10 - 2026-11-02
- Fixed: with WP_DEBUG on, the plugin no longer writes a "RateLimiter: no instance registered" line to the debug log on every page load.
1.0.9 - 2026-11-02
- Fixed: the Top 10 and revenue concentration charts keep their full height when the charts panel is first opened, reopened, or shown on a narrow screen.
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.