Driver Management
Driver profiles, vehicle assignment, custom attributes, bulk upload, and assignment history.
Last updated April 17, 2026
Driver Management Overview
The Drivers module provides complete driver lifecycle management including profile creation, vehicle assignment, custom attribute tracking, and assignment history logging.
Driver Table
| Column | Description |
|---|---|
| Profile | Driver name and profile picture |
| Address | Registered address (city, state, country) |
| Primary User | Assigned primary user account |
| Status | Active or Inactive |
| Created At | Account creation timestamp |
Filters
- Name — search by driver name
- Username — search by login username
- Email — search by email address
- Status — filter by Active or Inactive
Create Driver Modal
| Field | Required | Description |
|---|---|---|
| Primary User | Yes | Searchable dropdown with loading state and + Add New User quick-create |
| Driver Name | Yes | Placeholder text provided; min 2 characters |
| Optional | Email with optional prefix display | |
| Username | Yes | Unique login username |
| Password | Yes | Account password |
| Country | Yes | Country selection (required) |
| State | Optional | State/province selection (optional, loading states) |
| City | Optional | City selection (optional, loading states) |
| Address | Optional | Free-text address |
| Pincode | Optional | Postal/ZIP code |
Loading states are shown for: prefixes (phone country codes), states (per country), and cities (per state).
Driver Detail View
The driver detail view includes a user fallback name display, a loading details indicator, and a "Back to list" navigation link.
Edit Driver
The edit modal includes a Driver Attributes section allowing custom key-value pairs. Features include: add attribute button, key/value placeholders for each pair, and a 'no attributes' empty state message.
Password Management
| Field | Description |
|---|---|
| Title | Change Password dialog header |
| Subtitle | General password change description |
| SubtitleFor | Named driver reference (e.g., 'Change password for John') |
| New Password | New password input field |
| Confirm Password | Must match new password |
| Success | Generic success toast message |
| SuccessFor | Named success message (e.g., 'Password changed for John') |
| Failed | Error toast message on failure |
Vehicle Assignment
- Current Assignment section shows the currently assigned vehicle
- Select Vehicle dropdown to choose a vehicle for assignment
- States: Assigned (vehicle linked) or Unassigned (no vehicle)
- Validation: 'select required' — a vehicle must be selected to save
Assignment Logs
The Assignment Logs section (title: Assignment History) displays a chronological history of vehicle assignments for this driver. A fetching state is shown while loading the history.
Bulk Upload
The driver bulk upload page includes a "Go back" link to return to the driver list. It follows the same CSV-based multi-step wizard as other bulk imports.
Assign Modal (Bulk)
The assign modal supports both single and bulk assignment. It shows a title, a bulk title with description, a select user dropdown, and handles loading/searching users states.