Create a Task Manually
A task is the core unit of work to be completed by drivers (ex: a pickup OR delivery). To create a task manually, click the + button in the toolbar and select New Task… or use the keyboard shortcut T. You can also create a task from the map.
A window will appear with required fields to designate a recipient (or none), the type of task (dropoff or pickup), as well as a destination. Optional fields such as recipient notes, task details and a delivery time window are also available.
Recipient
If the task includes a recipient, the name and phone number are required. If this recipient has been created before, the phone number will be recognized and the name and notes will fill automatically. To remove a recipient, suppressing all notifications for this task, simply check the box labeled No recipient.
Recipient notes should be used for specific instructions that apply to all tasks for this recipient ie: door codes, special drop-off locations, warnings, etc. Recipient notes will remain attached to this recipient and will appear on all their tasks until overwritten or deleted.
Details
Optional details can be added to describe the work to be performed, the items to pickup/deliver, or even a link to an external document, website, or app.
Destination
A destination address must be entered and selected from the available drop-down options. If your address cannot be found or is invalid, you will need to correct it and select from the drop-down to continue. Ensure that the address includes a full street number and street name, and select the exact match from the dropdown to allow proper geocoding.
Note: Only addresses with a street name and number are considered valid. Addresses without a street name and number or more generally described (e.g. "Pier 4") will not be accepted.
Geocoding can be skipped during task creation by entering coordinates for the task destination in the dashboard and on task import sheets. Destination details must be input to be displayed to drivers and dispatchers, however, they aren't used in geocoding. To use coordinates as a workaround, open a mapping tool, locate the destination, and copy the latitude and longitude. Enable the "Use coordinates" option in Onfleet’s task creation window and paste the values into the respective fields.
Alternatively, you can also create a task from a specific location on the map. Destination coordinates will be captured through the map at the exact location where the task has been created.
Troubleshooting Address Validation Errors
Address validation errors can occur during task creation in Onfleet, often accompanied by messages suggesting you contact support or try again later. These errors typically arise when the destination address cannot be geocoded properly, such as when it resolves only to a county instead of a specific city.
Common Causes of Address Validation Errors
The destination address lacks a full street number and street name.
The address cannot be validated and geocoded to a specific location.
The delivery time window (Complete After/Before) is not set in the future.
Step-by-Step Troubleshooting Guide
Verify the Destination Address
Ensure the address includes a full street number and street name.
Select the exact match from the address dropdown to allow proper geocoding.
Check the Delivery Time Window
Confirm that the delivery time window is set in the future. Tasks cannot be created with past time windows.
Use Coordinates as a Workaround If the address still cannot be validated (e.g., it resolves only to a county):
Open a mapping tool and locate the destination.
Copy the latitude and longitude of the location.
In Onfleet’s task creation window, enable the "Use coordinates" option.
Paste the latitude and longitude into the respective fields.
Note: While destination address details are not required when using coordinates, adding them can be helpful for reference purposes.
Additional Tips
Double-check the address format to ensure it adheres to standard conventions.
If issues persist, consider reaching out to Onfleet support for further assistance.
Time Window
If your tasks follow a schedule or you have provided an estimated fulfillment time to your customer, use the time window section to establish a Complete After and Complete Before time. Ensure that the Complete After and Complete Before times are set in the future, as tasks cannot be created with past time windows.
Route Optimization Constraints
Note: You must enable Route Optimization to see and use this feature. For more information- check out this article.
Optionally, you can specify a task's quantity and individual service time to be considered during route optimization. See Define a Task's Quantity and Service Time.
Assignment
Assignment of the task to a driver (or a Connected Organization) can be performed now, or you can do it after task creation via the sidebar or map.
Clone a Task
To create a new task with all the same details as another task, right-click on the task in the sidebar to open the context menu and select the "Clone" option:
Alternatively, you can also open the task by double-clicking it on the map or sidebar and selecting "Clone" at the bottom left corner.
Note that the recipient and destination are always retained. Complete After/Before times are also carried over if that time hasn't already passed, and the task metadata and barcode fields will be checked by default if they are present in the task.
Finally, all metadata associated with the original task will also be carried over when that task is cloned. Your newly cloned task will appear in the unassigned section of the sidebar.
Create a Task From the Map
To create a task from the map, right-click on any location on the map which best corresponds to the delivery address, and select "Create a task here":
A window will appear with required fields to designate a recipient (or none) and the type of task (Dropoff or Pickup).
The recipient's destination coordinates will be captured through the map at the exact location where the task has been created. If you'd like to edit or verify the destination details, click the "Edit Destination Details" button below the destination coordinates. If a street address can be derived from the coordinates, it will appear here and can be edited further. Keep in mind that the Destination Details are for display purposes only and the coordinates will be used to place the pin and to navigate the driver.
Optional fields such as recipient notes, task details, a delivery time window, and assignment to a driver are also available. For a detailed walk-through about manual task creation through the dashboard, please see here.
If the recipient of a task you are creating has already been a recipient in the past, the fields will auto-complete based on the phone number you enter in the first field, once you de-select that field.
If you would like to update the recipient name associated with a phone number that you have already entered, you may do so. This will update that name within your Onfleet dashboard database for any instances of that phone number moving forward.
