# Fusion Insight

The **Fusion Insight** tab is FleetFusion's AI-driven dashboard surface. Instead of a fixed grid of KPIs, it shows a list of saved dashboards — built either by you, by a colleague, or generated by the InsightFusion AI Assistant — and lets you switch between them, edit their layout, or create new ones. Each dashboard is composed of widgets (KPIs, charts, tables, maps, and media cards) that the platform renders against your tenant's data.

> **Permissions:** Any user with the **Dashboard** permission can open this tab. Editing, saving, and deleting dashboards may require additional permissions on InsightFusion. Widget data is always scoped to the fleets, depots, drivers, and cost centres your role grants you access to.

To open the tab, click **Dashboard** in the sidebar, then select **Fusion Insight** from the tab strip.

<figure><img src="/files/Jy3dTA2DAHYGrAiBba6L" alt=""><figcaption></figcaption></figure>

## The toolbar

A single toolbar runs along the top of the tab. It carries:

* The **Dashboard** dropdown, which lists every saved dashboard you have access to. Selecting one loads its widgets onto the canvas below.
* The **Depots** multi-select, which narrows widgets to one or more depots.
* The **Drivers** multi-select, which narrows widgets to one or more drivers.
* The **New** button, which creates a fresh empty dashboard.
* The **Edit** button, which switches the canvas into a drag-and-resize mode so you can rearrange widgets.
* The **Save** button, which persists pending edits, including renames, layout changes, and any AI-generated dashboards you have just previewed from the assistant.
* The **Delete** button, which removes the currently-selected dashboard.

The shared **Date** range and **Fleets** filter that sits above the tab strip applies here too. Changing it updates every widget on the dashboard in place — there is no separate date control inside the tab.

> **Tip:** Use **Edit** to rename a dashboard. While editing, the dashboard name in the toolbar becomes a text field and the toolbar shows an **Unsaved** marker until you click **Save**.

## How widgets are arranged

When you open a dashboard, widgets render into a CSS grid that preserves the saved positions and sizes. Each widget occupies one or more grid cells so that wide charts can sit beside narrow KPIs.

While **Edit** mode is active, the grid switches to a draggable layout. You can:

* Drag a widget by its handle (the grip icon in the header) to reposition it.
* Resize a widget by dragging its bottom-right corner.
* Re-order widgets to suit your reading flow.

Click **Save** when you are happy. Until then, layout changes are kept locally and the **Unsaved** marker stays visible.

## Widget types

The same widget body template is used in both view and edit mode, so widgets look identical in either state. Common types include:

* **KPI tiles** rendered through the standard summary card chrome — value, label, delta, and an icon. The same component used by the Compliance, Fleet Activity, and Safety Overview tabs.
* **Charts** — bar, pie, radar, sankey, treemap, heatmap, and calendar heatmap, all themed to the Fusion Insight palette.
* **Tables** with per-column search filters and optional drill-through to a detail view.
* **Media cards** for safety events, showing a thumbnail, the event title, vehicle, severity pill, location, and time. Clicking a card opens the underlying event.
* **Map widgets** that plot markers (for vehicles, sites, or events) and **activity maps** that colour points by a chosen attribute.

A small status pip on each widget tells you whether the widget rendered successfully (**OK**), came back empty, returned a warning, failed, or has not yet been implemented for your data. Empty and failed widgets show a friendly inline message instead of an empty chart.

> **Tip:** Where a widget supports drill-through, hover the row or card — the cursor switches to a pointer and the row highlights. Clicking opens the matching detail page with filters preserved.

## Creating dashboards with the AI Assistant

You do not have to build dashboards by hand. You can ask the InsightFusion AI Assistant for one in plain English — for example, "Build me a dashboard of fuel use by depot over the last 90 days" — and the assistant will generate a preview, persist it on the server, and let you save it to this tab in one click. Once saved, the new dashboard appears in the **Dashboard** dropdown and behaves like any other.

For details on prompting the assistant, see the [InsightFusion AI Assistant](/documentation/getting-started/ai-assistant.md) article.

## Loading and empty states

You see a spinner with **Loading dashboards** while the tab fetches your dashboards. If you have not created or saved any dashboards yet, the canvas reads **No dashboards yet** — click **New** or ask the assistant to build one. An open dashboard with no widgets reads **Empty dashboard** until you add one.

## Related articles

* [Dashboard overview](/documentation/core-modules/dashboard.md)
* [Fleet Activity](/documentation/core-modules/dashboard/fleet-activity.md)
* [Safety Overview](/documentation/core-modules/dashboard/safety-overview.md)
* [InsightFusion AI Assistant](/documentation/getting-started/ai-assistant.md)
* [Vehicle details](/documentation/core-modules/vehicles/vehicle-details.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fleetfusion.ai/documentation/core-modules/dashboard/fusion-insight.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
