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

# Dashboard Widgets

> The visuals a dashboard can show, and every ready-made widget you can add.

A **widget** is one tile on a dashboard. Each widget counts or averages tasks in a set way and draws the result as a number, a chart, a table, a map or a piece of text. You pick widgets from a catalog of ready-made ones; each comes with its own name and description and already works with your data. To build your own, see [Custom Widget](https://docsy3.mile.app/pages/analytics/dashboard/custom-widget.md).

> [!NOTE]
>
> Required permission:
>
> * View dashboard (to see widgets)
> * Edit dashboard (to add, rename or remove widgets)

## Visuals

| Visual | Shows | Example |
| - | - | - |
| **Single number** (KPI) | One figure for the time range. | Total Tasks, Avg Travel Duration |
| **Bar chart** | One value per group. A bar can be split in two, for example by hub and by status. | Completed by Hub, Status by Hub |
| **Trend line** | One point per day, week or hour, to show change over time. | Volume Trend, Completion Trend |
| **Donut chart** | The parts of a whole, with each slice's count and share. | Tasks by Status, User by Status |
| **Table** | Rows of numbers, such as tasks per assignee. | Tasks by Assignee, User Activity |
| **Free text** | A note you write, shown next to the numbers. | Text / Note |
| **Banner** | A full-width strip for a heading or an announcement. | Banner |
| **Density map** | Where tasks are done, on a map. Busier spots glow brighter. | Task Location Heatmap |

### Tables

A table widget lists one row per group, most first, with the count beside it. **Tasks by Assignee**, for example, shows each assignee's email and how many tasks they had in the time range. The **User Activity** table has these columns:

| Column | What's there |
| - | - |
| **No.** | The row number. |
| **User** | The field user. |
| **Assigned** | Tasks assigned to the user. |
| **Ongoing** | Their tasks still in progress. |
| **Done** | Their finished tasks. |
| **Percentage** | The share of their tasks that is done. |

### Density map

![Task Location Heatmap](https://mintcdn.com/mile-app/PeReiScL9I1UXMJO/images/v4/analytics/widget-heatmap.png?fit=max\&auto=format\&n=PeReiScL9I1UXMJO\&q=85\&s=fd1bf31d9b3a04697f659b39bff6a179)

The density map puts each done task on the map at the spot where it was finished. Zoom with **+** and **−** or the mouse wheel. Tasks with no coordinate are left out; when none in the range has one, the widget says *No locations to map*. With very many tasks the map shows a sample, marked *Sampled*, or only the densest spots, marked *Densest cells*.

### Text and banner

A **Free text** widget holds a note, for example how to read the numbers or whom to call. A **Banner** spans the whole width, for a heading or a notice such as planned maintenance. Both show text you type, up to 2,000 characters, and run no query. See [Editing a Dashboard](https://docsy3.mile.app/pages/analytics/dashboard/editing-a-dashboard.md#change-a-widget) to write the text.

## Widget catalog

The **Add** dialog groups the ready-made widgets in eight categories; a ninth tab, **Custom**, holds **Create widget** and your organization's [widget templates](https://docsy3.mile.app/pages/analytics/dashboard/widget-templates.md). Widget names that say **Flow** count by flow.

Some widgets measure time instead of counting tasks: how long tasks took, how late they were, how old the open ones are, the share that is done, or when work gets done. They read the same as a [custom widget with a time measure](https://docsy3.mile.app/pages/analytics/dashboard/custom-widget.md#time-measures): a duration shows as days, hours and minutes (for example **1d 4h** or **2h 10m late**), a single number says *Based on N tasks*, and a **Few tasks** chip appears when fewer than 5 tasks were used. Time measures are averages only: no median or percentile, no min/max of a duration, no on-time count, and age counts only tasks in the dashboard range.

### Overview

| Widget | Visual | What it shows |
| - | - | - |
| Total Tasks | Single number | Tasks whose start time falls in the selected range, across every status. |
| Completed Tasks | Single number | Tasks starting in the selected range that are now Done. |
| Active Tasks | Single number | Tasks starting in the selected range that are still in progress (Ongoing). |
| Tasks Due in Range | Single number | Tasks whose end time falls in the selected range, across every status. |
| Due and Completed | Single number | Tasks whose end time falls in the selected range that are now Done. |
| New Tasks Created | Single number | Tasks created in the selected range, across every status. |
| Completion Rate | Single number | The share of the tasks starting in the selected range that are now Done, as a percentage. |

### Task status

| Widget | Visual | What it shows |
| - | - | - |
| Tasks by Status | Donut chart | The comparison of tasks by status. |
| Ongoing | Single number | Tasks starting in the selected range that are still Ongoing. |
| Done | Single number | Tasks starting in the selected range whose status is now Done. |
| Unassigned | Single number | Tasks still Unassigned among those starting in the selected range: work nobody has picked up yet. |
| Tasks by Label | Donut chart | How the tasks starting in the selected range split across labels, top 10. |
| Overdue Open Tasks | Single number | Tasks starting in the selected range that are still Unassigned or Ongoing and whose end time has already passed. |
| Stalled Ongoing Tasks | Single number | Ongoing tasks starting in the selected range that have not been updated for more than 24 hours. |
| Due and Still Open | Single number | Tasks whose end time falls in the selected range that are still Unassigned or Ongoing. |
| Overdue Open Tasks by Flow | Bar chart | Tasks starting in the selected range that are still Unassigned or Ongoing and whose end time has passed, per flow, top 10, most first. |
| Status by Flow | Bar chart | Tasks starting in the selected range per flow, each bar split by status; top 10 flows. |
| Status by Label | Bar chart | Tasks starting in the selected range per label, each bar split by status; top 10 labels. |
| Status by Source | Bar chart | Tasks starting in the selected range per created from, each bar split by status; top 10. |
| Unassigned by Flow | Bar chart | Tasks starting in the selected range that nobody has picked up yet (Unassigned), per flow, top 10, most first. |
| Open Tasks by Flow | Bar chart | Tasks starting in the selected range that are still Unassigned or Ongoing, per flow, top 10, most first. |
| Avg Age of Open Tasks | Single number | How long, on average, the tasks created in the selected range that are still Unassigned or Ongoing have existed until now. |
| Open Tasks by Age | Bar chart | Tasks created in the selected range that are still Unassigned or Ongoing, by how long ago they were created: **Under 1 day**, **1–3 days**, **3–7 days**, **7 days or more**. |
| Overdue Tasks by Days Late | Bar chart | Tasks whose end time falls in the selected range and has already passed, still Unassigned or Ongoing, by how long they are past it: **Under 1 day**, **1–3 days**, **3–7 days**, **7 days or more**. |

### Productivity

| Widget | Visual | What it shows |
| - | - | - |
| Tasks by Flow | Bar chart | Tasks starting in the selected range, per flow, top 10. |
| Tasks per Assignee | Bar chart | The 8 assignees with the most tasks starting in the selected range, busiest first; a task with several assignees counts for each of them. |
| Tasks by Source | Bar chart | Tasks starting in the selected range, per created from, top 10. |
| Task Activity | Bar chart | The count of tasks per day by start time, distinguished by flow. |
| Completed by Label | Bar chart | Done tasks whose done time falls in the selected range, per label, top 10, most first. |

### Time & Duration

| Widget | Visual | What it shows |
| - | - | - |
| Avg Travel Duration | Single number | Average travel duration per task, in minutes, for tasks starting in the selected range; tasks without a travel duration are left out. |
| Total Travel Time | Single number | Total travel duration, in minutes, of the tasks starting in the selected range; tasks without a travel duration are left out. |
| Longest Travel Time | Single number | The longest travel duration of a single task, in minutes, among tasks starting in the selected range. |
| Tasks with Travel Time | Single number | Tasks starting in the selected range that have a travel duration. |
| Travel Duration by Hub | Table | Per hub, the tasks starting in the selected range, plus the average and longest travel duration in minutes among those that have one; top 10 hubs. |
| Travel Duration by Flow | Table | Per flow, the tasks starting in the selected range, plus the average and longest travel duration in minutes among those that have one; top 10 flows. |
| Travel Duration per Assignee | Table | Per assignee, the tasks starting in the selected range, plus the total and average travel duration in minutes among those that have one; top 10 assignees, and a task with several assignees counts for each of them. |
| Travel Duration Trend | Trend line | Average travel duration per task, in minutes, for each day of the selected range by start time; tasks without a travel duration are left out. |
| Avg Completion Time | Single number | Average time from created to done of the tasks whose done time falls in the selected range. |
| Completion Time Trend | Trend line | Average time from created to done, for each day of the selected range by done time, in Jakarta time. |
| Completion Time by Flow | Table | Per Flow, the done tasks whose done time falls in the selected range and their average time from created to done; the 10 Flows with the most tasks, slowest first. |
| Completion Time by Hub | Bar chart | Average time from created to done per hub, for tasks whose done time falls in the selected range; the 10 hubs with the most tasks. |
| Completion Time per Staff | Table | Per done by, the done tasks whose done time falls in the selected range and their average time from created to done; the 10 staff with the most tasks, slowest first. |
| Avg Lateness vs Deadline | Single number | Average time between the end time and the done time of the tasks done in the selected range, shown as early, late or *On time*. |
| Lateness by Flow | Table | Per Flow, the done tasks whose done time falls in the selected range and their average lateness against the end time; the 10 Flows with the most tasks, latest first. |

### Team

| Widget | Visual | What it shows |
| - | - | - |
| Tasks by Assignee | Table | Tasks starting in the selected range, per assignee, top 10, most first; a task with several assignees counts for each of them. |
| Completed per Assignee | Table | Done tasks whose done time falls in the selected range, per done by, top 10, most first. |
| Tasks by Creator | Bar chart | Tasks starting in the selected range, per created by: the 8 users who created the most. |
| User Activity | Table | The summary of all tasks assigned and completed by the user. |
| User by Status | Donut chart | The comparison of assignment task. Active = assigned user. Inactive = unassigned user. |
| Active Field Staff | Single number | Number of different assignees with at least one task starting in the selected range. |
| Staff Who Completed Tasks | Single number | Number of different done by users with at least one Done task whose done time falls in the selected range. |
| Task Creators | Single number | Number of different created by users among the tasks starting in the selected range. |
| Overdue Tasks per Assignee | Table | Ongoing tasks starting in the selected range whose end time has passed, per assignee, top 10, most first; a task with several assignees counts for each of them. |
| Ongoing per Assignee | Table | Ongoing tasks starting in the selected range, per assignee, top 10, most first; a task with several assignees counts for each of them. |
| Assignee Workload by Hub | Bar chart | Tasks starting in the selected range for the top 10 assignees, each bar split by hub (top 5 hubs); a task with several assignees counts for each of them. |
| Tasks Assigned by Dispatcher | Bar chart | Tasks starting in the selected range, per assigned by, top 10, most first; tasks without assigned by are left out. |
| Completions per Staff by Flow | Bar chart | Done tasks whose done time falls in the selected range, per done by (top 10), each bar split by flow (top 5 flows). |
| Last Completion per Staff | Table | Per done by, the time of their last done task in the selected range and how many tasks they finished; the 10 staff with the most done tasks, most recent first. |

### Hub

| Widget | Visual | What it shows |
| - | - | - |
| Tasks by Hub | Donut chart | How the tasks starting in the selected range split across hubs, top 10. |
| Completed by Hub | Bar chart | Done tasks whose done time falls in the selected range, per hub, top 10. |
| Task Location Heatmap | Density map | Tasks whose done time falls in the selected range, mapped by done coordinate. |
| Active Hubs | Single number | Number of different hubs with at least one task starting in the selected range. |
| Overdue Open Tasks by Hub | Bar chart | Tasks starting in the selected range that are still Unassigned or Ongoing and whose end time has passed, per hub, top 10, most first. |
| Due and Open by Hub | Bar chart | Tasks whose end time falls in the selected range and that are still Unassigned or Ongoing, per hub, top 10, most first. |
| Status by Hub | Bar chart | Tasks starting in the selected range per hub, each bar split by status; top 10 hubs. |
| Unassigned by Hub | Bar chart | Tasks starting in the selected range that nobody has picked up yet (Unassigned), per hub, top 10, most first. |
| Flow Mix by Hub | Bar chart | Tasks starting in the selected range per hub (top 10), each bar split by flow (top 5 flows). |
| Weekly Volume by Hub | Bar chart | Tasks starting in each week of the selected range, each bar split by hub (top 5 hubs); weeks begin on Monday, so the first and last week may be partial. |
| Daily Volume by Hub | Bar chart | Tasks starting per day across the selected range, each bar split by hub (top 5 hubs), in Jakarta time. |
| Daily Completions by Hub | Bar chart | Done tasks per day by done time across the selected range, each bar split by hub (top 5 hubs), in Jakarta time. |

### Trend

| Widget | Visual | What it shows |
| - | - | - |
| Volume Trend | Trend line | Tasks per day by start time across the selected range, in Jakarta time; days with none show as gaps. |
| Completion Trend | Trend line | Done tasks per day by done time across the selected range, in Jakarta time; days with none show as gaps. |
| Weekly Volume | Bar chart | Tasks starting in each week of the selected range, in Jakarta time; weeks begin on Monday, so the first and last week may be partial. |
| Weekly Completions | Bar chart | Done tasks per week by done time across the selected range, in Jakarta time; weeks begin on Monday, so the first and last week may be partial. |
| Deadlines per Day | Bar chart | Tasks per day by end time across the selected range, across every status, in Jakarta time. |
| Hourly Completions | Trend line | Done tasks per hour by done time across the selected range, in Jakarta time; hours with none show as gaps. |
| Hourly Task Starts | Trend line | Tasks starting in each hour of the selected range, in Jakarta time; hours with none show as gaps. |
| Completion Rate Trend | Trend line | For each day of the selected range by start time, the share of tasks that are now Done, in Jakarta time. |
| Completions by Hour of Day | Bar chart | Done tasks whose done time falls in the selected range, added up per hour of the day, **00** to **23**, in your browser's time zone. |
| Completions by Day of Week | Bar chart | Done tasks whose done time falls in the selected range, added up per weekday, **Mon** to **Sun**, in your browser's time zone. |

### Utility

| Widget | Visual | What it shows |
| - | - | - |
| KPI Summary | Single number | A general-purpose number widget; out of the box it counts the tasks starting in the selected range, across every status. |
| Text / Note | Free text | A free-text widget for notes, instructions, or context next to the numbers. |
| Banner | Banner | A full-width text strip for a heading or announcement across the dashboard. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.