# Notifications

The Notifications dashboard is a four-column landing page that surfaces the alerts most likely to need your attention right now. It groups active alerts by severity and pulls media-download alerts into their own column so you can see at a glance whether a clip you requested has arrived.

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

> **Permissions:** The Notifications dashboard requires the `FleetAssistant.Alerts` policy. Administrators and Fleet Managers typically have this permission; Standard Users see only the alerts their role is allowed to view.

> **Note:** This page is gated by the `FleetAssistant.Alerts` permission. If the page does not appear in your sidebar, ask an administrator to grant your role the **Alerts** permission under **Roles & Permissions**.

## What you can do

* See active alerts grouped into four buckets: **Critical**, **Warning**, **Info**, and **Media Downloads**.
* Click any alert to jump to the related record and acknowledge the alert in the background.
* Mark an entire column as read with one click.
* See your unread count at a glance.

## Opening the Notifications dashboard

To open the dashboard, click **Notifications** in the sidebar, or navigate directly to `/notifications/dashboard`.

The full management list at `/notifications` is still available for searching, filtering, and bulk acknowledgement; the dashboard is a faster overview for day-to-day use.

## The four columns

The dashboard layout has one column for each alert category. Each column lists the most recent active alerts of that type, newest first.

| Column          | Accent colour | What it contains                                                                                                                                                   |
| --------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Critical        | Red           | Alerts with severity **Critical** that need immediate attention - for example, a vehicle reporting an engine fault or an offline tracker on a critical asset.      |
| Warning         | Amber         | Alerts with severity **Warning** - for example, a service due soon, a fuel-card anomaly, or a geofence dwell time exceeded.                                        |
| Info            | Blue          | Alerts with severity **Info** that do not relate to media downloads - for example, "vehicle moved depot" or "new document uploaded".                               |
| Media Downloads | Sky blue      | Alerts whose underlying kind is `MediaDownload`. This column tells you when a video clip you (or another user) requested is ready to view, regardless of severity. |

Each card in a column shows:

* The alert title and a short description.
* A **source pill** showing which subsystem raised the alert (for example, the integration name or the alert kind).
* A relative time label - **Xm**, **Xh**, or **Xd** since the alert was raised.

## Working an alert

To work through an alert:

1. Open the **Notifications** dashboard.
2. Read the alert title and source. The most urgent alerts are in the left-most column (Critical) and at the top of each column.
3. Click the alert card.
   * If the alert refers to a specific record, FleetFusion opens the management list filtered to that record's entity type and ID.
   * If the alert has no record reference, FleetFusion opens the full management list at `/notifications`.
4. The alert is **acknowledged** in the background. It moves out of the active list and your unread count drops by one.

To clear a whole column at once, click the column's **Mark all read** action. Every active alert in the column is acknowledged in a single batch.

> **Tip:** Use the column-level mark-as-read action carefully - it acknowledges every alert in the column, not just the ones currently visible.

## Alert types

The alerts that appear here are raised by other parts of FleetFusion as you use them, including:

* **Tracking** - geofence transitions, dwell time exceeded, in-zone speed limit breaches.
* **Video** - when a [video event](/documentation/fleet-operations/tracking/video-events.md) is flagged for coaching, or when a requested clip download finishes (Media Downloads column).
* **Maintenance and Workshop** - service due, MOT due, defect raised in a walkaround check.
* **Integrations** - sync failures and configuration errors from your connected providers.
* **System** - device offline, telematics provider outage, licence-check failures.

The exact list depends on which features and integrations your organisation has enabled.

## How alerts are sourced

Each column pulls from the same underlying alert service used by the full management list, with the appropriate severity filter applied. The Critical column shows only Critical-severity alerts; the Media Downloads column is sourced from the broadest list and matches alerts whose kind is exactly `MediaDownload`. This matters when a media-download alert happens to carry a higher severity - it still appears in Media Downloads, not in Critical.

## Related articles

* [Tracking](/documentation/fleet-operations/tracking.md)
* [Geofences](/documentation/fleet-operations/tracking/geofences.md)
* [Video events](/documentation/fleet-operations/tracking/video-events.md)
* [Roles and permissions](/documentation/settings/roles-and-permissions.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/fleet-operations/notifications.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.