Medusa Analytics Plugin

Get actionable insights into your store's performance and make data-driven decisions right from the Medusa Admin dashboard.

Overview

The Medusa Analytics Plugin is a lightweight analytics extension for the Medusa Admin dashboard. It provides store admins with a clear view of sales and product performance using focused KPIs, charts, and tables, all accessible directly within the Medusa Admin panel.

✅ Compatible with Medusa v2.11.0 and above

Requirements

• Medusa v2.11.0+ - This plugin requires Medusa v2.11.0 or later due to its dependency on the Caching Module, which was introduced in that version.

Features

• Date Range Picker with presets: This Month, Last Month, Last 3 Months, Custom Range (applies to all analytics)
• Tabbed Interface: Switch between Orders and Products analytics
• Charts & KPIs:
  • Orders Tab:
    • Total Orders (KPI)
    • Total Sales (KPI)
    • Orders Over Time (Line Chart)
    • Sales Over Time (Line Chart)
    • Top Regions by Sales (Bar Chart)
    • Order Status Breakdown (Pie Chart)
  • Products Tab:
    • Top-Selling Products (Bar Chart)
    • Out-of-Stock Variants (Table)
    • Low Stock Variants (Table)

Widgets

The plugin also injects analytics widgets directly into existing admin list pages, so you can view key metrics without leaving your current context:

• Orders Widget — appears at the top of the Orders list page (order.list.before zone):

  • Total Sales (KPI)
  • Total Orders (KPI)
  • Average Order Value (KPI)

• Products Widget — appears at the top of the Products list page (product.list.before zone):

  • Top-Selling Products (Bar Chart)
  • Low Stock Variants (Table)
  • Bottom-Selling Products (Bar Chart)

• Customers Widget — appears at the top of the Customers list page (customer.list.before zone):

  • New vs. Returning Customers (Chart)
  • Top Customer Groups by Sales (Chart)
  • Average Sales per Customer (Chart)

Each widget includes its own interval selector (This Month, Last Month, Last 3 Months, Custom Range) for quick filtering.

Getting Started

1. Install the plugin in your Medusa project:

   yarn add @agilo/medusa-analytics-plugin

2. Add the plugin to your Medusa backend configuration. In medusa-config.ts, add the following to the plugins array:

   plugins: [
     {
       resolve: '@agilo/medusa-analytics-plugin',
       options: {},
     },
     // ...other plugins
   ],

3. Install dependencies:

   yarn

4. Start your Medusa server:

   yarn dev

5. Access the Analytics page from the Medusa Admin dashboard.

Contributing

We welcome contributions and feedback. To get involved, open an issue or submit a pull request on GitHub →