Overview
↑ Back to topCustomer Analytics for WooCommerce is a powerful analytics extension that provides advanced customer metrics and insights beyond standard WooCommerce reporting. It helps store owners track customer lifetime value, repeat purchase rates, churn rates, and geographic sales distribution to make data-driven decisions about their business.
Key Benefits
↑ Back to top- Understand Customer Value: Track lifetime value metrics to identify your most valuable customer segments
- Monitor Customer Retention: Measure repeat purchase rates and churn to optimize retention strategies
- Geographic Insights: Analyze sales performance by country to optimize international strategies
- Flexible Reporting: Filter data by date ranges, customer segments, and behavior patterns
- Data Export: Export reports for external analysis and presentation
Requirements
↑ Back to top- WordPress: 6.0 or higher
- WooCommerce: 9.0 or higher
- WooCommerce HPOS: High-Performance Order Storage must be enabled
- PHP: 8.3 or higher
- MySQL: 8.0 or higher
- Browser: Modern browser with JavaScript enabled
Installation Guide
↑ Back to topStep-by-Step Installation
↑ Back to top- Download the Plugin — Obtain the
customer-analytics.zipfile from your purchase receipt or download area - Upload to WordPress — Navigate to WordPress Admin → Plugins → Add New, click “Upload Plugin”, choose the downloaded ZIP file, and click “Install Now”
- Activate the Plugin — After installation completes, click “Activate Plugin”. Alternatively, go to Plugins → Installed Plugins and activate Customer Analytics
- Verify HPOS is Enabled — Go to WooCommerce → Settings → Advanced → Features, ensure “High-Performance order storage” is enabled. If not enabled, check the box and save settings
- Initial Configuration — Navigate to WooCommerce → Analytics → Customer Analytics → Settings tab, configure threshold values for customer segmentation, and save your settings
Troubleshooting Installation Issues
↑ Back to top- Plugin doesn’t appear after activation: Clear your browser cache and WordPress cache
- Missing menu items: Ensure your user role has the
manage_woocommercecapability - JavaScript errors: Check for plugin conflicts by temporarily disabling other plugins
Features & Metrics
↑ Back to top1. Lifetime Value (Customer Lifetime Value / CLV)
↑ Back to topLocation: WooCommerce → Analytics → Customer Analytics → Lifetime Value tab
Track the average revenue generated by customers over their entire relationship with your store.
Metrics Displayed
- Average lifetime value: Mean revenue per customer in your store’s currency
- Average customer lifetime (months): Duration in months customers remain active
Important Notes
- Calculations are based on order creation date (not completion or payment date)
- Fully refunded orders are excluded from all metrics
- Guest orders are grouped by billing email address
Customer Segmentation
Selectable from dropdown with percentage of each segment displayed:
- All customers: Complete customer base analysis
- One-time buyers: Customers with exactly 1 order
- Repeat customers: Customers with 2–4 orders (configurable)
- Loyal customers: Customers with 5+ orders (configurable threshold)
Available Filters
- Date range selection (day, week, month, quarter, year)
- Customer segment filtering
Data Export: CSV download available for all table data
2. Lifetime Value Trends (Cumulative CLV)
↑ Back to topLocation: WooCommerce → Analytics → Customer Analytics → Lifetime Value Trends tab
Monitor how customer lifetime value evolves over time with cumulative tracking.
Metrics Displayed
- Average lifetime value: Progressive CLV calculation over time
- Average customer lifetime (months): Trending customer relationship duration
Important Notes
- Calculations are based on order creation date
- Fully refunded orders are excluded from calculations
- Guest orders are grouped by billing email address
Special Features
- Lookback Period: Configure how many months of historical data to include
- Historical Tracking: Monitor CLV changes over time
- Segmentation: Same customer segments as standard CLV report
Configuration Options
- Loyal customer threshold (default: 5 orders)
- Lookback period in months (optional, uses all data if empty)
CLV vs. Cumulative CLV — Which Report to Use
↑ Back to topThe Lifetime Value and Lifetime Value Trends reports use fundamentally different methodologies, which is why they may show different values for the same date range.
Lifetime Value (Cohort-based)
- Includes only customers who made their first purchase within the selected date range
- Tracks their behavior over their entire lifetime (including beyond the report period)
- For single-purchase customers, estimates lifetime using median time to second purchase from all repeat customers
- Perspective: Forward-looking cohort analysis — “How valuable are customers acquired in this period?”
Lifetime Value Trends (Snapshot-based)
- Includes all customers who have ever purchased up to each point in time (filtered by optional lookback period)
- Shows a snapshot of your entire customer base at each interval
- Perspective: Backward-looking health check — “How was the customer base evolving during this period?”
Customer Segment Percentages
The two reports also calculate segment percentages (one-time, repeat, loyal) differently:
- Lifetime Value: Counts all orders each cohort customer has made up to today. Shows how the acquisition cohort has evolved (e.g., “40% of January customers became loyal”).
- Lifetime Value Trends: Counts orders only up to the end of the selected date range. Shows the customer mix at a specific point in time (e.g., “25% of all customers were loyal as of January 2024”).
When to Use Each Report
Use Lifetime Value when you want to:
- Analyze the quality of customer acquisitions from specific periods
- Track how cohorts evolve over their entire lifetime
- Compare acquisition performance across different time periods
Use Lifetime Value Trends when you want to:
- See historical snapshots of your entire customer base
- Track overall business health over time
- Understand customer composition at specific points in history
3. Repeat Purchase Rate
↑ Back to topLocation: WooCommerce → Analytics → Customer Analytics → Repeat Purchase Rate tab
Measure the percentage of customers who make multiple purchases.
Metrics Displayed
- Repeat purchase rate (%): Percentage of customers with 2+ orders
- Repeat customers: Absolute count of returning customers
- Total customers: Complete customer count for the period
Important Notes
- Based on order creation date for tracking customer activity
- Fully refunded orders are excluded from the analysis
- Repeat purchase rate in chart/table summary is an overall repeat purchase rate for the selected period
Tip: If you have insufficient data points for the selected interval (e.g., very few daily data points), try selecting a longer interval like “month” instead of “day” for more meaningful analysis.
Analysis Features
- Time-series visualization of repeat purchase trends
- Period-over-period comparisons
- Downloadable data for external analysis
Filters
- Date range selection
- Interval grouping (hour, day, week, month, quarter, year)
4. Churn Rate
↑ Back to topLocation: WooCommerce → Analytics → Customer Analytics → Churn Rate tab
Track customer attrition and identify when customers stop purchasing.
Metrics Displayed
- Churn rate (%): Percentage of customers who haven’t purchased within the churn period
- Churned customers: Count of inactive customers
- Total customers: Active customer base size
Important Notes
- Churn calculations use order creation date to determine customer activity periods
- Fully refunded orders are not counted as valid purchases for churn analysis
- Churn rate in chart/table summary is churn rate at the end of period
Churn Period Options
- 15 days
- 30 days
- 60 days
- 90 days (default)
- 4 months (120 days)
- 6 months (180 days)
- 1 year (365 days)
- 2 years (730 days)
Analysis Capabilities
- Trend analysis with reverse trend indicators (lower is better)
- Period comparison to identify seasonal patterns
5. Countries
↑ Back to topLocation: WooCommerce → Analytics → Customer Analytics → Countries tab
Analyze sales performance across different geographic regions.
Metrics Displayed
- Items sold: Product quantity by country
- Net sales: Calculated as Gross sales minus Coupons (matching WooCommerce
Analytics → ProductsandAnalytics → Categoriesmethodology) - Orders: Total order count per country
View Modes
- All countries: Overview of all countries with sales
- Single country: Deep dive into one country’s performance
- Comparison: Compare multiple countries side-by-side
Advanced Features
- Product segmentation for single country view (top 10 products)
Note: Country is determined by billing address, not shipping address.
Settings & Configuration
↑ Back to topAccessing Settings
↑ Back to topNavigate to WooCommerce → Analytics → Customer Analytics → Settings tab in your WordPress admin menu.
Available Settings
↑ Back to top1. Lifetime Value loyal customers threshold
- Purpose: Define the minimum number of orders for a customer to be considered “loyal”
- Default Value: 5
- Impact: Affects customer segmentation in Lifetime Value reports
2. Lifetime Value Trends loyal customers threshold
- Purpose: Set loyal customer threshold specifically for trends report
- Default Value: 5
- Impact: Affects customer segmentation in Lifetime Value Trends reports
3. Lifetime Value Trends lookback period
- Purpose: Filters which customers to include based on when they were acquired (first purchase date)
- Default Value: Empty (includes all historical customers)
- Format: Number of months (e.g., “36” for 3 years)
- Impact: Only includes customers who made their first purchase within X months before the report start date; affects customer segment percentages by excluding customers whose first purchase was before the lookback cutoff; also affects median time to second purchase calculation for single-purchase customers; can improve performance by reducing data processing scope
- When to Use: When you want to analyze only recently acquired customers; when older customer cohorts had significantly different behavior patterns; for performance optimization with very large datasets
- Example: With a 12-month lookback and report date range of January 2024, only includes customers who made their first purchase after January 2023
- Note: The lookback period is calculated from the report START date, not the end date
- Period Comparisons: When comparing periods (e.g., Year to date vs. Previous year), the lookback is applied independently to each period. This means you’re comparing “recent customers from 2024” vs. “recent customers from 2023” rather than the same customer cohort across both periods
Best Practices for Configuration
↑ Back to top- Start with defaults: The default values work well for most stores
- Adjust based on your business: e.g., B2B stores might use higher thresholds
- Monitor performance: Use lookback periods for stores with extensive history
- Consistency: Keep thresholds aligned between related reports
Usage Guide
↑ Back to topAccessing the Analytics Dashboard
↑ Back to top- Main Navigation: Find “WooCommerce → Analytics → Customer Analytics” in your WordPress admin menu
- Submenu Access: Click any report from the dropdown menu
- Direct URLs: Bookmark specific reports for quick access
Navigating Reports
↑ Back to topDate Range Selection
- Click the date picker in the top toolbar
- Choose from presets (Today, Year to date, Last month, etc.)
- Or select custom date range
- Click “Update” to refresh data
Applying Filters
- Use the “Show” dropdown to select customer segments (Lifetime Value and Lifetime Value Trends reports)
- For Churn Rate, select the churn period to define customer inactivity threshold
- For Countries report, choose between All/Single/Comparison view modes
- Repeat Purchase Rate shows all customers without filtering options
- Filters automatically update charts and tables when changed
Understanding Charts
- Hover for details: Mouse over data points for specific values
- Legend interaction: Click legend items to show/hide data series
Customizing Reports
↑ Back to topColumn Management
- Click the ellipsis menu in table headers
- Select “Columns” to show/hide specific columns
- Changes persist in your user preferences
Sorting Data
- Click any column header to sort by that metric
- Click again to reverse sort order
- Default sort varies by report type
Exporting Data
↑ Back to topCSV Export
- Locate the “Download” button above any data table
- Click to generate CSV file
- File includes all visible columns and rows
- Use Excel, Google Sheets, or other tools for analysis
Data Requirements for Reliable Analytics
↑ Back to topMinimum Data
↑ Back to topYou need at least 100 customers and 3–6 months of order data for meaningful analytics.
Better Results With
↑ Back to top- More customers: 300+ customers produce more accurate metrics
- More history: 12+ months of data reveals real trends
- Regular purchases: Weekly or monthly buyers generate more reliable patterns than yearly buyers
Warning Signs Your Data May Be Insufficient
↑ Back to top- Metrics fluctuating wildly between intervals (30%+ changes)
- A single large customer is significantly skewing the results
- Fewer than 30 customers in a given report period
- Analysis period shorter than your typical customer purchase cycle
In general, More data leads to more reliable insights.
Avoiding Recency Bias
↑ Back to topRecency bias occurs when recent customers appear less valuable simply because they haven’t had enough time to demonstrate their full behavior patterns — not because they’re actually worse customers.
Exclude Recent Data from Business Decisions
↑ Back to topThe exclusion period should match your typical customer purchase cycle:
| Purchase Cycle | Exclusion Period | Example |
|---|---|---|
| Weekly | 30 days | Groceries, consumables |
| Monthly | 60 days | Subscription boxes, regular services |
| Quarterly | 90 days | Seasonal products, B2B supplies |
| Bi-annual | 180 days | Fashion, electronics |
| Annual | 365 days | Insurance, enterprise software |
Best Practices
↑ Back to top- Match analysis period to purchase cycle: Weekly purchase products should be analyzed over quarterly periods; monthly products over yearly periods
- Use complete periods only: Analyze full months or quarters that ended at least one purchase cycle ago, rather than partial periods
- Compare like with like: Compare January 2024 to January 2023 — not an incomplete current week to a complete prior month
Key principle: The more recent the data, the less reliable the metrics. When you see concerning trends in recent data, wait at least one full purchase cycle before taking action.
Data Accuracy
↑ Back to top- Order Status: Only includes orders based on WooCommerce Analytics settings
- Refunded Orders: Fully refunded orders are excluded from all reports and calculations
- Date Calculations: All metrics use order creation date (not completion or payment date)
- Net sales (Countries): Calculated as Gross sales minus Coupons, matching WooCommerce’s Products and Categories reports
- Guest Orders: Grouped by billing email for CLV calculations
Troubleshooting & FAQ
↑ Back to topCommon Issues and Solutions
↑ Back to topReports Show No Data
- Cause: No orders in the selected date range
- Solution: Expand the date range or check order data exists
Slow Report Loading
- Cause: Large dataset without lookback period
- Solution: Set lookback period in settings for CLV reports
Incorrect Currency Display
- Cause: WooCommerce currency settings
- Solution: Verify currency in WooCommerce → Settings → General
Missing Customer Analytics Menu
- Cause: Insufficient user permissions
- Solution: Ensure user has
manage_woocommercecapability
Chart Not Displaying
- Cause: JavaScript error or conflict
- Solution: Check browser console, disable conflicting plugins
Error Message: “There was an error getting your stats. Please try again.”
- Cause: The error occurs when there’s a problem with your current session
- Solution: Refresh the page and re-authenticate with WordPress if prompted
Frequently Asked Questions
↑ Back to topCan I customize the customer segment thresholds?
Yes, through WooCommerce → Analytics → Customer Analytics → Settings tab, you can adjust loyal customer thresholds.
Does this work with subscription products?
Subscription orders from WooCommerce Subscriptions are included in the calculations like regular orders.
What determines a “churned” customer?
A customer is churned if they haven’t made a purchase within your configured churn period (default 90 days).
How often is data updated?
Reports use current data from your WooCommerce database.
Can multiple users access reports simultaneously?
Yes, multiple users can view reports at the same time.
Known Limitations
↑ Back to top- Maximum 100 items per page in data tables
- Country reports based on billing country (not shipping)
- Guest customer grouping relies on billing email accuracy
Feedback
↑ Back to topWe welcome your feedback to help shape development. Please report bugs or suggest features through our contact form. When reporting issues, include your WooCommerce version, store size, and any error messages to help us assist you better.
