# Add & Edit Driver

The Add & Edit Driver modal is used to create or update a driver profile. It is split into two tabs: Basic and Additional. These tabs include personal info, payroll setup, emergency contact, off-duty logic, and driver preferences. Users can also define whether the driver is a company employee, 3rd party contractor, or owner (sole prop or company).

The driver status is determined by their creation path. Regular drivers go to the Active list once saved. If invite toggle is enabled during applicant creation, they go to the Applicant list.

Key Rules:

* Drivers cannot be assigned to trucks or trailers from this modal.
* Some fields and payroll modes depend on driver type (Company, 3rd Party, Owner).
* Once a driver has completed an active load, changing their payroll type is restricted.
* Off-Duty Location table can be used to configure custom time-off mapping.

**Image Placeholder:**\
`![DriverModalBasic](../assets/driver-modal-basic.png)`\
\&#xNAN;*Figure: Add Driver modal with Basic tab fields and payroll logic.*

#### Basic Tab

<table><thead><tr><th width="200">Field</th><th width="90" align="center">Required</th><th>Description</th></tr></thead><tbody><tr><td>First Name</td><td align="center">✅</td><td>Driver’s legal first name</td></tr><tr><td>Last Name</td><td align="center">✅</td><td>Driver’s legal last name</td></tr><tr><td>Phone Number</td><td align="center">✅</td><td>Primary phone number</td></tr><tr><td>Email</td><td align="center">Optional</td><td>Used only if invite is enabled</td></tr><tr><td>Address</td><td align="center">✅</td><td>Residential address (street, city, state, ZIP)</td></tr><tr><td>Owner Type</td><td align="center">✅</td><td>Determines if driver is Sole Proprietor, Company, or 3rd Party</td></tr><tr><td>Payroll Type</td><td align="center">✅</td><td>Determines how the driver is paid (Per Mile, Commission, Flat Rate)</td></tr><tr><td>Pay Rate</td><td align="center">✅</td><td>Base rate depending on payroll type</td></tr><tr><td>Invite Driver</td><td align="center">Optional</td><td>Sends invite if email is present</td></tr><tr><td>Emergency Contact</td><td align="center">Optional</td><td>Full name, phone, and relationship</td></tr><tr><td>Off-Duty Location</td><td align="center">Optional</td><td>Locations and days the driver is off-duty</td></tr><tr><td>Document Upload</td><td align="center">Optional</td><td>Profile photo or additional documents</td></tr></tbody></table>

#### Additional Tab

<table><thead><tr><th width="200">Field</th><th width="90" align="center">Required</th><th>Description</th></tr></thead><tbody><tr><td>Profile Photo</td><td align="center">Optional</td><td>Image used in card/list view</td></tr><tr><td>Fuel Cards</td><td align="center">Optional</td><td>Linked fuel cards issued to the driver</td></tr><tr><td>TWIC Expiration Date</td><td align="center">Optional</td><td>Port access card expiration tracking</td></tr><tr><td>MVR Renewal Date</td><td align="center">Optional</td><td>Manually tracked MVR expiration</td></tr><tr><td>Notification Rules</td><td align="center">Optional</td><td>Driver-specific preferences for reminders and compliance alerts</td></tr></tbody></table>

#### Edit Logic

* Summary of what changes affect what
* Deactivation behavior
* Save actions (Save Changes, Save and Add New)


---

# 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://rute.gitbook.io/carrier/add-and-edit-driver.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.
