The vehicles list
Navigate to Vehicles in the sidebar to see your entire fleet in one place. The page opens with a header showing the total vehicle count and three clickable KPI tiles that also serve as quick filters.
KPI tiles
| Tile | What it shows |
|---|---|
| Active Vehicles | Count of vehicles with is_active set to true, out of the total fleet size |
| With Incidents | Vehicles that have had at least one incident reported in the last 30 days |
| Due Maintenance | Vehicles whose next service date has passed (only visible when fleet_maintenance_enabled is on) |
Clicking any tile filters the table below to show only matching vehicles. Click the same tile again (or click the Clear filter link) to remove the filter.
Fleet health bar
When the Fleet Maintenance module is enabled, a Fleet Health Bar appears below the KPI tiles. This horizontal bar visualizes the proportion of your fleet in each health category:
- Healthy (green) — Health score 80 or above. No overdue reminders, valid TUV, recent mileage update.
- Needs Attention (yellow) — Score between 50 and 79. Some reminders approaching due date or mileage data getting stale.
- Critical (red) — Score below 50. Overdue service reminders, expired TUV, or significantly stale mileage.
- Stale Mileage — Vehicles whose mileage has not been updated within the configured threshold (default: 30 days).
Each segment of the bar is clickable and acts as a filter for the vehicle table. This gives you an instant visual sense of overall fleet condition.
Pay close attention to the Critical count. Vehicles in critical health may have overdue safety inspections or expired certifications, and should be flagged for immediate service.
Vehicle table
Below the health bar, the full vehicle table lists every vehicle with searchable columns:
- Plate Number — The license plate, linked to the vehicle detail page
- Make / Model / Year — Vehicle identification
- Status — Custom vehicle status (set in Settings), displayed as a colored badge
- Health Score — A numeric score with a colored indicator (green / amber / red)
- Incident Count — Total incidents for the vehicle
- Last Incident Date — When the most recent incident was reported
Use the built-in search bar at the top of the table to find vehicles by plate number, make, or model.
Vehicle detail page
Click any vehicle row to open its detail page. This page is organized into several tabbed sections:
Incident history
A complete list of every incident linked to this vehicle, sorted by date. Each entry shows the incident type, status badge, driver name, dispatcher assigned, and reported date. Click any incident to navigate to the full incident detail page.
The top of the tab shows summary statistics:
- Total incidents
- Breakdown by status:
NEW,IN_REVIEW,CLOSED - Breakdown by type: Minor Scratch, Major Damage, Window, Tire, Other
You can also create a new incident directly from this tab using the Add Incident button, which pre-fills the vehicle information.
Maintenance tab
When fleet_maintenance_enabled is active, this tab shows:
- Current mileage and average daily kilometers
- Health score with a visual indicator
- TUV valid until date (if applicable)
- Active service reminders with status (Pending, Notified, or Overdue) and due dates
- Maintenance logs — A history of completed services with dates, vendors, and costs
- Completed reminders — Past reminders that have been resolved, showing who completed them
- Templates — Maintenance templates that apply to this specific vehicle (by direct assignment, model pattern match, or org-wide scope)
Repair history
When the vendor_workflow_enabled module is active, the vehicle detail page includes a repairs section showing all repair jobs linked to this vehicle, including vendor information, status, and cost details.
Shift calendar
The vehicle detail page displays a calendar or timeline view of recent shifts where this vehicle was used, allowing you to cross-reference shift activity with incident reports and inspection findings.
When you see a vehicle appearing frequently in the incident-prone list on your dashboard, open its detail page and compare the incident history against its maintenance logs. A pattern of recurring damage types (e.g., repeated tire incidents) often signals a mechanical issue that maintenance can address.
Understanding fleet health scoring
The health score for each vehicle is computed from three factors:
- Service reminders — Active reminders in Pending, Notified, or Overdue status reduce the score. Overdue reminders have the largest negative impact.
- TUV validity — If the vehicle's TUV (technical inspection) certificate is expired or expiring soon, the score drops.
- Mileage freshness — If the vehicle's mileage has not been updated within the stale threshold (configurable, default 30 days), the score is penalized.
A score of 80+ means the vehicle is in good standing. Between 50 and 79, it needs attention. Below 50, it is critical and should be prioritized for service. The fleet health bar on the main vehicles page aggregates these scores across your entire fleet for a quick overview.