> ## Documentation Index
> Fetch the complete documentation index at: https://docs.swiftlywp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Analytics Dashboard

> Track box sales, popular items, fill rates, and revenue.

<Info>
  The Analytics Dashboard is a **Pro feature**. [Upgrade to BoxBuilder Pro →](https://swiftlywp.com/plugin/boxbuilder-for-woocommerce/)
</Info>

BoxBuilder Pro includes a built-in analytics dashboard at **BoxBuilder → Analytics** that gives you insights into how your box products are performing.

## Dashboard Metrics

The analytics dashboard shows these key metrics:

| Metric                      | Description                                             |
| --------------------------- | ------------------------------------------------------- |
| **Total Orders with Boxes** | Number of orders containing at least one box product    |
| **Total Boxes Sold**        | Total number of box products sold                       |
| **Total Revenue**           | Revenue generated from box products                     |
| **Total Items in Boxes**    | Total number of individual items placed in boxes        |
| **Average Fill Rate**       | How full customers are filling their boxes (percentage) |
| **Average Order Value**     | Average value of orders containing boxes                |

## Reports

### Most Popular Products

A chart showing which products are most frequently added to boxes. Helps you understand customer preferences and stock accordingly.

### Top Selling Box Products

A table showing your best-performing box products by revenue and units sold.

### Top Boxes

A table showing which box configurations generate the most orders and revenue.

### Fill Rate Analysis

Understand how customers use your boxes:

* Are they filling boxes to capacity, or leaving spots empty?
* Which box sizes have the best fill rate?
* Does fill rate correlate with box capacity?

## Date Ranges

Filter analytics by time period:

| Range              | Description             |
| ------------------ | ----------------------- |
| **Last 7 days**    | Previous week           |
| **Last 30 days**   | Previous month          |
| **Last 90 days**   | Previous quarter        |
| **Last 12 months** | Previous year           |
| **All time**       | Since plugin activation |

## Dashboard Overview

The main **BoxBuilder → Dashboard** page also shows summary stats:

* Active Boxes (published box products)
* Boxes Sold (total count)
* Revenue (Pro only)

These give you a quick glance without visiting the full analytics page.

## Export

Export analytics data as CSV for use in spreadsheets or reporting tools. Click the **Export** button on the analytics page.

## Performance

Analytics queries run against WooCommerce order item meta — no custom database tables. Results are cached using WordPress object cache and refreshed when order statuses change.
