> ## Documentation Index
> Fetch the complete documentation index at: https://docsv4.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.
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 |
| **Heat 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. |
### Heat map
The heat 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](/pages/analytics/editing-a-dashboard#change-a-widget) to write the text.
## Widget catalog
The **Add** dialog groups the widgets in eight categories. Widget names that say **Flow** count by task type.
### 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. |
### 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 task type, top 10, most first. |
| Status by Flow | Bar chart | Tasks starting in the selected range per task type, each bar split by status; top 10 task types. |
| 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 task type, top 10, most first. |
| Open Tasks by Flow | Bar chart | Tasks starting in the selected range that are still Unassigned or Ongoing, per task type, top 10, most first. |
### Productivity
| Widget | Visual | What it shows |
| - | - | - |
| Tasks by Flow | Bar chart | Tasks starting in the selected range, per task type, 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 task type. |
| 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 task type, the tasks starting in the selected range, plus the average and longest travel duration in minutes among those that have one; top 10 task types. |
| 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. |
### 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 task type (top 5 task types). |
### 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 | Heat 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 task type (top 5 task types). |
| 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. |
### 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.