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

# Analytics & Dashboards

> Track hiring metrics, pipeline health, and workforce KPIs with customizable dashboards

## Overview

The **Analytics** module provides customizable dashboards and charts for monitoring your hiring pipeline, workforce metrics, and operational KPIs. Build real-time dashboards that give you visibility into every aspect of your HR operations.

## Dashboards

A **Dashboard** is a collection of widgets arranged to visualize your key metrics:

| Feature             | Description                                        |
| ------------------- | -------------------------------------------------- |
| Custom Layout       | Drag-and-drop widget arrangement                   |
| Multiple Dashboards | Create dashboards for different teams and purposes |
| Sharing             | Share dashboards across your organization          |
| Auto-Refresh        | Real-time data updates                             |
| Default Dashboard   | System-generated dashboard with key metrics        |

## Charts and Widgets

### Chart Types

| Chart Type     | Use Case                                                  |
| -------------- | --------------------------------------------------------- |
| **Bar Chart**  | Compare values across categories (applications per stage) |
| **Line Chart** | Track trends over time (applications per week)            |
| **Pie Chart**  | Show distribution (application sources)                   |
| **Number/KPI** | Single metric display (total applications today)          |
| **Table**      | Detailed data view (candidate list)                       |
| **CSV Chart**  | Charts from imported CSV data                             |

### Widget Groups

**Widget Groups** organize related widgets:

* Group by hiring flow, stage, or department
* Collapsible sections for organized dashboards
* Shared filters across grouped widgets

## Stage Groups

**Stage Groups** enable cross-flow analytics by categorizing stages across multiple hiring flows:

```
Stage Group: "Screening"
├── Hiring Flow A → Stage: "Initial Review"
├── Hiring Flow B → Stage: "Phone Screen"
└── Hiring Flow C → Stage: "Application Review"
```

This allows you to track metrics like:

* Total candidates in "Screening" across all flows
* Average time in "Interview" stages
* Drop-off rates at "Background Check" stages

## Key Metrics

### Hiring Metrics

| Metric                | Description                                       |
| --------------------- | ------------------------------------------------- |
| Applications Received | New applications over time                        |
| Time to Hire          | Average days from application to offer            |
| Stage Conversion      | Percentage of candidates advancing between stages |
| Drop-Off Rate         | Where candidates leave the pipeline               |
| Source Attribution    | Which channels produce the most candidates        |
| Offer Acceptance Rate | Percentage of offers accepted                     |

### Pipeline Metrics

| Metric                    | Description                                        |
| ------------------------- | -------------------------------------------------- |
| Pipeline Health           | Current candidates per stage                       |
| Stage Duration            | Average time candidates spend in each stage        |
| Bottleneck Detection      | Stages with growing candidate queues               |
| Compliance Pass Rate      | Percentage of candidates passing compliance checks |
| Automation Execution Rate | Success/failure rates of automations               |

### Workforce Metrics

| Metric              | Description                           |
| ------------------- | ------------------------------------- |
| Active Contracts    | Current active workforce count        |
| Onboarding Progress | New hires and their completion status |
| Training Completion | LMS course completion rates           |
| Document Compliance | Percentage of up-to-date documents    |
| Turnover Rate       | Contract terminations over time       |

## Filters and Segmentation

Dashboards support filtering by:

* **Date range** — Last 7 days, 30 days, custom range
* **Hiring flow** — Specific pipeline
* **Stage** — Specific stage or stage group
* **Legal entity** — Organization subdivision
* **Location** — Work location
* **Source** — Application source

## Default Dashboard

Firstwork automatically generates a **Default Dashboard** with essential metrics for quick visibility:

* **Pipeline Overview** - Candidate count per stage across active hiring flows.

  * **Application Trends** - Weekly/monthly application volume with trend indicators.

  * **Conversion Funnel** - Stage-to-stage conversion rates for each hiring flow.

  * **Active Workforce** - Current contract count by status and entity.

## Custom Reports

Export analytics data for external reporting:

* CSV export for any chart or table
* Scheduled email reports
* API access for building custom dashboards
* Integration with BI tools via webhooks
