Product Analytics WHMCS Addon
WHMCS addon module providing detailed analytics and reports for products, product groups, clients, and orders. Includes dashboard overview, revenue analysis, churn tracking, client lifetime value, and order statistics with multi-currency support.
Description
Product Analytics addon WHMCS
Order now | Download | FAQ
PUQ Product Analytics — WHMCS Addon
PUQ Product Analytics is an addon module for WHMCS that provides comprehensive analytics and reports for your products, product groups, clients, and orders. Gain instant insights into your business performance with interactive dashboards, revenue breakdowns, churn analysis, and client lifetime value reports.
Key Features
- Dashboard Overview — complete business snapshot with key metrics, service status donut chart, recurring revenue, subscription trends, and top products/groups rankings
- Products Overview — sortable table of all products with active, suspended, terminated, and total service counts
- Revenue by Product — recurring revenue breakdown per product, normalized to annual and monthly estimates, with multi-currency support
- Product Popularity — new subscriptions, retention, and actual revenue from paid invoices for a selected period with monthly charts
- Product Churn — churn and retention rate analysis per product with color-coded visual bars to identify at-risk products
- Groups Overview — summary of all product groups with service counts and status breakdown
- Revenue by Group — recurring revenue breakdown per product group with multi-currency support
- Group Distribution — donut chart visualization of service distribution across all product groups
- Clients Overview — client status breakdown, age distribution, and new registration trends
- Client Lifetime Value — average LTV per currency, revenue distribution brackets, and top clients by total revenue
- Client Revenue — detailed per-client revenue table with lifetime, invoices paid, and monthly value
- Orders Overview — order statistics by status per currency with monthly order and revenue charts
- Orders by Product — product ranking by number of orders and total revenue for a selected period
- Multi-currency support — all reports display data separately per currency
- Date range filters — flexible period selection on applicable reports (This Month, This Year, Last 30 Days, Last 12 Months, Last 2 Years, All Time)
- Real-time search and sorting — all tables support instant filtering and column sorting
- License system — online/offline license verification with graceful degradation (dashboard remains accessible without a license)
- English language interface
System Requirements
| Requirement | Minimum |
|---|---|
| WHMCS | 8.x, 9.x |
| PHP | 8.1, 8.2+ |
| ionCube Loader | v13 or newer (v14, v15) |
Links
- Product page: https://puqcloud.com/
- Documentation: https://doc.puq.info/books/product-analytics-whmcs-addon
- Support: https://puqcloud.com/submitticket.php
- Community: https://community.puqcloud.com/
Changelog
Product Analytics addon WHMCS
Order now | Download | FAQ
v1.0 — 2026-02-15
First release.
New Features
- Dashboard with key metrics overview (products, groups, clients, services, retention rate)
- Services by Status donut chart on dashboard
- Recurring Revenue cards with multi-currency support
- Orders (Last 30 Days) summary on dashboard
- New Subscriptions (12 mo) bar chart on dashboard
- Top Products by Active Services ranking on dashboard
- Top Groups by Services ranking on dashboard
- Products Overview report with sortable product table
- Revenue by Product report with annual/monthly estimates per currency
- Product Popularity report with date range filter, subscription stats, and monthly charts
- Product Churn report with churn/retention rates and color-coded visual bars
- Groups Overview report with group table and service counts
- Revenue by Group report with per-group revenue breakdown
- Group Distribution report with donut chart visualization
- Clients Overview report with status breakdown, age distribution, and new clients chart
- Client Lifetime Value report with LTV stats, revenue distribution, and top clients
- Client Revenue report with detailed per-client revenue table
- Orders Overview report with order stats by currency and monthly charts
- Orders by Product report with product ranking by order volume
- Date range filters (This Month, This Year, Last 30 Days, Last 12 Months, Last 2 Years, All Time)
- Multi-currency support across all reports
- Real-time search and column sorting on all tables
- License verification system with online/offline modes
- Dashboard accessible without active license, other pages restricted
- English language interface
Installation and Update
Product Analytics addon WHMCS
Order now | Download | FAQ
System Requirements
| Requirement | Minimum |
|---|---|
| PHP | 8.1, 8.2 or newer |
| WHMCS | 8.x, 9.x or newer |
| ionCube Loader | v13 or newer (v14, v15) |
Note: The module uses ionCube encoding. Make sure ionCube Loader is installed and active on your server.
Download
The module can be ordered and downloaded from PUQ Cloud:
- Order / Download: https://puqcloud.com/store/whmcs-addon-modules
- FAQ: https://community.puqcloud.com/
- Direct download links:
PHP 8.1:
wget https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/php81/PUQ_WHMCS-Product-Analytics-latest.zip
PHP 8.2+:
wget https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/php82/PUQ_WHMCS-Product-Analytics-latest.zip
All versions are available at: https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/
After downloading, extract the archive:
unzip PUQ_WHMCS-Product-Analytics-latest.zip
Installation
Step 1: Upload Files
Extract the module archive and upload the puq_product_analytics directory to the WHMCS addons directory:
/your-whmcs/modules/addons/puq_product_analytics/
Directory structure after upload:
modules/addons/puq_product_analytics/
puq_product_analytics.php
hooks.php
whmcs.json
version
logo.png
lib/
puqProductAnalytics.php
lang/
english.php
templates/
...
Step 2: Activate the Module
- Log in to the WHMCS admin panel
- Go to Setup > Addon Modules
- Find PUQ Product Analytics in the list
- Click Activate
Step 3: Configure the License Key
- After activation, click Configure next to the module
- Enter your license key in the License key field
- Select admin role groups that should have access to the module
- Click Save Changes
After saving, a verification status will appear below the license key field (e.g., success: 2027-02-15T19:41:07+01:00).
01-addon-config-license.png
Step 4: Access the Module
Go to Addons > PUQ Product Analytics to access the dashboard and all reports.
Update
Step 1: Backup
Before updating, we recommend backing up:
- Your WHMCS database
- Module files in
modules/addons/puq_product_analytics/
Step 2: Upload New Files
Extract the new version and overwrite all files in:
/your-whmcs/modules/addons/puq_product_analytics/
Step 3: Verify
- Log in to the WHMCS admin panel
- Go to Addons > PUQ Product Analytics
- Check the version number in the top-right corner of the navigation bar (e.g.,
v1.0)
Re-activation is not required after updating. Simply overwrite the files and the new version is ready to use.
Deactivation
- Go to Setup > Addon Modules
- Click Deactivate next to PUQ Product Analytics
- Confirm the deactivation
Note: The module does not create any custom database tables. Deactivation simply removes the module from the active addons list.
License
The module requires an active license for full functionality. The license is verified through the PUQ Cloud license server.
How License Verification Works
- The module periodically checks license validity at
https://license.puqcloud.com/ - Verification results are cached in the database for 5 days
- If the license server is temporarily unreachable, the module uses the last cached result
Without an Active License
- Dashboard (Home page) remains fully accessible
- All other pages (Products, Groups, Clients, Orders) display a license required page
- All AJAX controllers (except Dashboard) return a 403 error
After Activating a License
Purchase a License
https://puqcloud.com/store/whmcs-addon-modules
https://puqcloud.com/submitticket.php
Dashboard
Product Analytics addon WHMCS
Order now | Download | FAQ
The Dashboard is the home page of the module, available at: Addons > PUQ Product Analytics > Home
It provides a complete overview of your WHMCS business at a glance — key metrics, revenue, service status, subscription trends, and top-performing products and groups.
02-dashboard.png
Key Metrics
The top row displays summary cards with the most important numbers:
| Metric | Description |
|---|---|
| Total Products | Number of products configured in WHMCS |
| Total Groups | Number of product groups |
| Total Clients | Number of registered clients |
| Active Services | Services with Active status |
| Total Services | Total number of services across all statuses |
| Retention Rate | Percentage of services that remain active (color-coded: green >= 70%, yellow >= 40%, red < 40%) |
Services by Status
A donut chart showing the distribution of all services by their current status:
- Active (green) — currently running services
- Suspended (yellow) — temporarily suspended
- Terminated (red) — permanently terminated
- Cancelled (gray) — cancelled by client or admin
- Pending (blue) — awaiting activation
Recurring Revenue
Displays estimated recurring revenue broken down by currency:
- Annual Revenue — total estimated yearly revenue from active services
- Monthly Revenue — normalized monthly estimate
- Each currency is shown separately (e.g., USD, EUR, PLN)
Orders (Last 30 Days)
Summary of recent order activity per currency, showing the number of orders and their total amount.
New Subscriptions (12 mo)
A bar chart showing the number of new service subscriptions per month over the last 12 months, helping you identify growth trends.
Top Products by Active Services
A horizontal bar chart ranking products by the number of currently active services.
Top Groups by Services
A horizontal bar chart ranking product groups by total service count, with the number of active services shown in parentheses.
Products
Product analytics reports: overview of all products, revenue breakdown per product, product popularity trends, and churn analysis.
Products Overview
Product Analytics addon WHMCS
Order now | Download | FAQ
The Products Overview page is available at: Addons > PUQ Product Analytics > Products > Products Overview
Summary of all products configured in WHMCS with active and total services count.
03-products-overview.png
Summary Cards
The top section displays four key metrics:
| Metric | Description |
|---|---|
| Total Products | Total number of products configured in WHMCS |
| Product Groups | Number of product groups |
| Active Services | Total services with Active status across all products |
| Total Services | Total number of services across all statuses |
Products Table
A sortable and searchable table listing every product with the following columns:
| Column | Description |
|---|---|
| # | Product ID in WHMCS |
| Product Name | Name of the product (clickable link) |
| Type | Product type (hostingaccount, server, other, etc.) |
| Group | Product group the product belongs to |
| Active | Number of active services (green badge) |
| Suspended | Number of suspended services (yellow badge) |
| Terminated/Cancelled | Number of terminated and cancelled services (red badge) |
| Total | Total number of services for this product |
The table supports real-time search filtering and column sorting.
Revenue by Product
Product Analytics addon WHMCS
Order now | Download | FAQ
The Revenue by Product page is available at: Addons > PUQ Product Analytics > Products > Revenue by Product
Recurring revenue breakdown per product, normalized to annual and monthly estimates.
04-revenue-by-product.png
Revenue Summary
The top section shows total revenue cards for each currency configured in WHMCS:
| Metric | Description |
|---|---|
| Annual Revenue | Total estimated annual recurring revenue |
| Monthly Revenue | Normalized monthly revenue estimate |
| Services | Number of active services contributing to this revenue |
Each currency (e.g., EUR, USD, PLN) is displayed as a separate card.
Revenue Table
A sortable and searchable table with per-product revenue breakdown:
| Column | Description |
|---|---|
| # | Product ID |
| Product Name | Name of the product |
| Group | Product group |
| Currency | Currency badge (color-coded) |
| Active | Number of active services |
| Annual Revenue | Estimated annual revenue from this product in this currency |
| Monthly Revenue | Estimated monthly revenue |
Note: Revenue is calculated from the recurring amount of active services. Products with multiple currencies appear as separate rows.
Product Popularity
Product Analytics addon WHMCS
Order now | Download | FAQ
The Product Popularity page is available at: Addons > PUQ Product Analytics > Products > Product Popularity
Product performance for the selected period — new subscriptions, retention, and actual revenue from paid invoices.
05-product-popularity.png
Date Range Filter
At the top of the page, a set of period buttons allows you to select the analysis timeframe:
- This Month — current calendar month
- This Year — current calendar year
- Last 30 Days — rolling 30-day window
- Last 12 Months — rolling 12-month window (default)
- Last 2 Years — rolling 24-month window
- All Time — entire history
Subscription Statistics
For each currency, four key metrics are displayed:
| Metric | Description |
|---|---|
| New Subscriptions | Number of new services created in the selected period |
| Still Active | How many of those new services are still active |
| Churned | How many of those new services have been terminated or cancelled |
| Revenue in Period | Actual revenue from paid invoices in the selected period |
Monthly Charts
Below the statistics, two charts are displayed per currency:
- New Subscriptions per Month — bar chart showing the number of new services created each month
- Revenue per Month — bar chart showing actual paid revenue per month
These charts help identify seasonal trends and growth patterns in product performance.
Product Churn
Product Analytics addon WHMCS
Order now | Download | FAQ
The Product Churn page is available at: Addons > PUQ Product Analytics > Products > Product Churn
Churn and retention analysis per product — identify which products lose the most customers.
06-product-churn.png
Summary Cards
The top section displays four key churn metrics:
| Metric | Description |
|---|---|
| Churn Rate | Overall percentage of services that have been terminated or cancelled |
| Retention Rate | Overall percentage of services that remain active |
| Churned Services | Total number of terminated and cancelled services |
| At Risk (Suspended) | Number of currently suspended services that may churn |
Churn by Product
A sortable and searchable table showing churn analysis per product:
| Column | Description |
|---|---|
| Product Name | Name of the product |
| Total | Total number of services (all statuses) |
| Active | Number of active services (green badge) |
| Suspended | Number of suspended services (yellow badge) |
| Churned | Number of terminated/cancelled services (red badge) |
| Churn Rate | Percentage of churned services with color-coded visual bar (green to red) |
| Retention Rate | Percentage of active services with color-coded visual bar (red to green) |
Tip: Products with high churn rate and many total services should be investigated first — they represent the biggest potential for improvement.
Groups
Product group analytics reports: overview of all groups, revenue breakdown per group, and service distribution across groups.
Groups Overview
Product Analytics addon WHMCS
Order now | Download | FAQ
The Groups Overview page is available at: Addons > PUQ Product Analytics > Groups > Groups Overview
Summary of all product groups with services count.
07-groups-overview.png
Summary Cards
The top section displays four key metrics:
| Metric | Description |
|---|---|
| Total Groups | Number of product groups configured in WHMCS |
| Total Products | Total number of products across all groups |
| Active Services | Total services with Active status |
| Total Services | Total number of services across all statuses |
Groups Table
A sortable and searchable table listing every product group:
| Column | Description |
|---|---|
| # | Group ID in WHMCS |
| Group Name | Name of the product group (clickable link) |
| Products | Number of products in this group |
| Active | Number of active services (green badge) |
| Suspended | Number of suspended services (yellow badge) |
| Terminated/Cancelled | Number of terminated and cancelled services (red badge) |
| Total | Total number of services in this group |
The table supports real-time search filtering and column sorting.
Revenue by Group
Product Analytics addon WHMCS
Order now | Download | FAQ
The Revenue by Group page is available at: Addons > PUQ Product Analytics > Groups > Revenue by Group
Recurring revenue breakdown per product group, normalized to annual and monthly estimates.
08-revenue-by-group.png
Revenue Summary
The top section shows total revenue cards for each currency:
| Metric | Description |
|---|---|
| Annual Revenue | Total estimated annual recurring revenue |
| Monthly Revenue | Normalized monthly revenue estimate |
| Services | Number of active services contributing to this revenue |
Each currency (e.g., EUR, USD, PLN) is displayed as a separate card.
Revenue Table
A sortable and searchable table with per-group revenue breakdown:
| Column | Description |
|---|---|
| # | Group ID |
| Group Name | Name of the product group |
| Products | Number of products in this group |
| Currency | Currency badge (color-coded) |
| Active | Number of active services |
| Annual Revenue | Estimated annual revenue from this group in this currency |
| Monthly Revenue | Estimated monthly revenue |
Note: Groups with products in multiple currencies appear as separate rows per currency.
Group Distribution
Product Analytics addon WHMCS
Order now | Download | FAQ
The Group Distribution page is available at: Addons > PUQ Product Analytics > Groups > Group Distribution
Distribution of services across product groups — see which groups have the most services.
09-group-distribution.png
Summary Cards
The top section displays four key metrics:
| Metric | Description |
|---|---|
| Total Groups | Number of product groups |
| Total Services | Total number of services across all groups |
| Active Services | Services with Active status |
| Ungrouped | Services belonging to products without a group |
Services Distribution
A large donut chart visualizing how services are distributed across all product groups. Each segment represents a group with:
- Group name — displayed in the legend
- Service count — total services in the group
- Percentage — share of total services
The chart includes all groups, even those with zero services, providing a complete picture of your product portfolio distribution.
Clients
Client analytics reports: overview of all clients, lifetime value analysis, and detailed revenue breakdown per client.
Clients Overview
Product Analytics addon WHMCS
Order now | Download | FAQ
The Clients Overview page is available at: Addons > PUQ Product Analytics > Clients > Clients Overview
Summary of all clients — status breakdown, age distribution, and new registrations.
10-clients-overview.png
Summary Cards
The top section displays four key client metrics:
| Metric | Description |
|---|---|
| Total Clients | Total number of registered clients |
| Paying Clients | Clients who have at least one paid invoice |
| Non-Paying | Clients with no paid invoices |
| Avg Lifetime | Average client lifetime in months |
Clients by Status
A donut chart showing the distribution of clients by their current status:
- Active (green) — clients with active services
- Inactive (yellow) — clients without active services
Client Age Distribution
A horizontal bar chart showing how long clients have been registered:
- < 1 mo — registered less than a month ago
- 1 - 3 mo — 1 to 3 months
- 3 - 6 mo — 3 to 6 months
- 6 - 12 mo — 6 months to 1 year
- 1 - 2 yr — 1 to 2 years
- 2 - 5 yr — 2 to 5 years
- 5+ yr — more than 5 years
New Clients per Month
A bar chart showing the number of new client registrations per month, helping you identify growth trends.
Client Lifetime Value
Product Analytics addon WHMCS
Order now | Download | FAQ
The Client Lifetime Value page is available at: Addons > PUQ Product Analytics > Clients > Client Lifetime Value
Average revenue per client, revenue distribution, and top clients by lifetime value.
11-client-lifetime-value.png
LTV Statistics
For each currency, five key metrics are displayed:
| Metric | Description |
|---|---|
| Average LTV | Average lifetime revenue per paying client |
| Total Revenue | Total revenue from all paid invoices |
| Avg Monthly Value | Average monthly revenue per paying client |
| Paying Clients | Number of paying clients (shown as paying / total) |
| Avg Lifetime | Average client lifetime in months |
Each currency (e.g., USD, EUR, PLN, UAH) is displayed as a separate row of cards.
Revenue Distribution
A horizontal bar chart per currency showing how clients are distributed across revenue brackets:
- $0 — clients with no revenue
- $0 - $50 — low-value clients
- $50 - $200 — medium-value clients
- $200 - $500 — higher-value clients
- $500 - $1K — high-value clients
- $1K - $5K — premium clients
- $5K+ — top-tier clients
Top Clients by Revenue
A horizontal bar chart per currency showing the highest-revenue clients, ranked by total paid amount.
Client Revenue
Product Analytics addon WHMCS
Order now | Download | FAQ
The Client Revenue page is available at: Addons > PUQ Product Analytics > Clients > Client Revenue
Detailed revenue breakdown per client with lifetime and monthly value.
12-client-revenue.png
Revenue Summary
For each currency, three key metrics are displayed:
| Metric | Description |
|---|---|
| Total Revenue | Total revenue from paid invoices in this currency |
| Total Clients | Number of clients with invoices in this currency |
| Paying Clients | Number of clients who have actually paid |
Each currency is displayed as a separate row of cards.
Client Revenue Table
A sortable and searchable table per currency with detailed client data:
| Column | Description |
|---|---|
| Client Name | Name of the client |
| Active | Client status badge (Active / Inactive) |
| Client Since | Registration date |
| Lifetime | How long the client has been registered (in months) |
| Invoices Paid | Total number of paid invoices |
| Total Revenue | Lifetime revenue from this client |
| Monthly Value | Average monthly revenue from this client |
The table supports real-time search filtering and column sorting.
Orders
Order analytics reports: overview of all orders with status breakdown, and product ranking by order volume.
Orders Overview
Product Analytics addon WHMCS
Order now | Download | FAQ
The Orders Overview page is available at: Addons > PUQ Product Analytics > Orders > Orders Overview
Summary of all orders with status breakdown, monthly chart, and recent activity.
13-orders-overview.png
Date Range Filter
At the top of the page, a set of period buttons allows you to select the analysis timeframe:
- This Month — current calendar month
- This Year — current calendar year
- Last 30 Days — rolling 30-day window
- Last 12 Months — rolling 12-month window (default)
- Last 2 Years — rolling 24-month window
- All Time — entire history
Order Statistics
For each currency, four key metrics are displayed:
| Metric | Description |
|---|---|
| Total Orders | Total number of orders with the total amount |
| Active | Number of orders with Active status and their total amount |
| Pending | Number of orders with Pending status |
| Cancelled / Fraud | Number of cancelled or fraudulent orders |
Each currency (e.g., PLN, EUR, UAH, USD) is displayed as a separate row of cards.
Monthly Charts
Below the statistics, two charts are displayed per currency:
- Orders per Month — bar chart showing the number of orders placed each month
- Revenue per Month — bar chart showing order revenue per month
These charts help identify order trends and seasonal patterns in sales activity.
Orders by Product
Product Analytics addon WHMCS
Order now | Download | FAQ
The Orders by Product page is available at: Addons > PUQ Product Analytics > Orders > Orders by Product
Ranking of products by number of orders and total revenue.
14-orders-by-product.png
Date Range Filter
At the top of the page, a set of period buttons allows you to select the analysis timeframe:
- This Month — current calendar month
- This Year — current calendar year
- Last 30 Days — rolling 30-day window
- Last 12 Months — rolling 12-month window (default)
- Last 2 Years — rolling 24-month window
- All Time — entire history
Order Statistics
For each currency, three key metrics are displayed:
| Metric | Description |
|---|---|
| Total Orders | Total number of orders in the selected period |
| Total Amount | Total revenue from orders |
| Products Ordered | Number of unique products that received orders |
Each currency is displayed as a separate row of cards.
Top Products
A horizontal bar chart per currency ranking products by the number of orders received in the selected period. This helps identify your best-selling products and understand which products drive the most order volume.