Route Planning


Arrivy’s Route Planning feature allows Schedulers to create and edit routes for crews that have multiple stops/Tasks during a single day. With Route Planning, Schedulers can rearrange Tasks within a single route or drag-and-drop Tasks between routes in order to balance them between your field teams.

Route Planning works differently from other features in Arrivy. The Route Planning interface provides a way to experiment with different Task layouts and assignments. Within this interface you can create new routes, drag-and-drop Tasks between and within routes, change route starting and ending times. No permanent changes are made to Tasks until you click the Publish button. Once you click Publish, all of the edits made in your Route Planning session will be propagated to the affected Tasks. Rescheduled messages may be sent to customers whose Task times have changed. Or, you can choose to have no messages sent.

The important thing to recognize is that Route Planning is an experimentation environment as opposed to an operational activity like Dispatch. You can work with Tasks on a given day; completely change times and assignments; save those changes and come back to your session three days later. No changes will be made to Tasks until you publish those changes using the Publish button.

See a demo video of Route Planning here:

You can access Route Planning from the Workflow nav. 

Clicking on the menu opens the Route Planning environment. There are four main regions in the interface:

  1. The Command Bar: Has a set of buttons that make global changes to the environment and Tasks.
    1. Create New Route initializes a new route without any Tasks
    2. Save saves the current configuration of Tasks and Routes for the given date without publishing changes. This configuration will be shown the next time Route Planning interface is bought-up for this date.
    3. Revert erases any changes made during the Route Planning session and reinitializes Tasks to their original state. 
    4. Publish Tasks & Routes makes the changes made in the Route Planning session, permanent. The Dashboard for the given date in Route mode should reflect the changes made in Route Planning.
  2. The Route Sidebar: Contains a set of Route Cards and (child) Task Cards that details route and Task configurations.
  3. The Map: Show Tasks pins and direction of Task travel.
  4. The Info Panel: Contains information on selected Tasks and Routes including the layout of Tasks on the chosen Route.
Elements of the Route Planning interface

Elements of the Route Planning interface


For many companies, routes begin at a transportation depot where crews pick-up (and drop-off) the vehicles they will be using for the day’s Tasks. The Route Planning feature lets you designate depots as starting and ending locations for your Routes. You can define any number of depots in Basic Settings for a company, or in Groups Settings if you are using Groups. Depot addresses work similarly to the way you add multiple addresses to a Task. Simply click on the “Add Depot Address” button as many times as desired and input the address(es) in the corresponding field. Make sure to save your changes.

Specifying a Depot name and address in Basic Settings

Specifying a Depot name and address in Basic Settings

Each Route can have its own separate Depot. However, a route must start and end at the same depot location. Within the Route Planning feature, there are two places you can designate a Depot for a Route.  Click the “kabob” menu on a Route card and choose Edit. The associated dialog will let you choose a depot, company or group location as start/end points.

If you use depots, the Map and Info Panel will show the Depot you have added to your route

Depot included in a route

Depot included in a route

The Route Sidebar

Routes are automatically created using in the Route Planning interface by grouping together Task having the same assignees. They can also be created using the New Route button. The Sidebar contains Route cards and Task cards grouped under them. 

The Route Planning sidebar

The Route Planning sidebar

Route Cards

Route cards are similar to those on the dashboard. 

Task Cards

Task cards contain Task details and timing. The Task bar in the middle of the card provides a graphical representation of the Task timing, showing the time window and duration in color. By viewing the Task bars of a group of Task cards together, you can get a good sense for the sequence of the route.

You can change dates, start time, end time or Task duration using the Task Info dialog (by clicking on the clock-pencil icon on the Task card). Note that any changes to Task times made through this dialog will not affect the actual Tasks until the route is published.

If the date, time, duration or assignees for the route have changed during the Route Planning session, the Edit Task button will be replaced by a yellow warning icon. Clicking on the icon will bring up a popover that identifies the changes and allows you to revert the changes and/or edit the Task. It will also flag issues–such as not having enough travel time between stops.

Schedule changes and other issues are shown by clicking on the warning icon.

Schedule changes and other issues are shown by clicking on the warning icon

The Unplanned Route Card

The Unplanned Route card is special. It cannot be deleted or renamed. It contains Tasks that are either unscheduled or scheduled with no assignees. The Unplanned route will only display Tasks plotted as individual pins/circles–not as a continuous route.

Route Editing in the Sidebar

The interface for route editing is primarily drag-and-drop. When a Task is dragged and dropped the start and end times are affected. The duration and time window stay constant. As the Task is dropped, the affected Tasks (those following the one dropped) are reordered based on the calculated travel times and Task durations. 

  • Tasks may be reordered within the same route by dragging and dropping Task Cards within the same route. The new target position of the Task within the route is shown in the usual way (dark line) while the Task Card is being dragged.
  • Dragging a Task Card onto a different Route Card will add this Task to that route. 

The Info Panel

The Info Panel and Route Bar provides tools for helping to understand and adjust Routes and Tasks. The Info Panel provides information and controls for adjusting Routes and Tasks. The Route Bar is a visual display of the layout of Tasks within a Route, over time. Clicking on a Task or Route in the Sidebar selects that Task or Route and displays relevant data in the Info Panel. 

If a Route is selected, the panel shows a variety of information and options, including:

  • Number of Tasks, route timing
  • Checkbox to start/end at depot
  • Starting time for the route
  • Padding added between Tasks (padding time is added to travel time to account for unpredictability)

If a Task is selected, the info panel shows:

  • Title, Customer, Address, Duration, Arrival Window info
  • Editable start/end times
  • Assignees
  • Edit Task icon

The Route Bar shows a horizontal view of all the Tasks associated with the selected route. It displays the entire route associated with either the selected Route or Task card.

Saving, Reverting and Compacting

You can click the Save button on the Command Bar to save the changes you’ve made during your current Route Planning session to persist them until your next session. If you don’t save your changes they will be discarded when you navigate to a different page of Arrivy or close your browser tab. Save will not make permanent changes to your Tasks. You must use Publish in order to affect permanent changes to Tasks

The Revert button will reverse any changes made and reload the original Task times and assignments. 

Compacting is the process of rearranging Tasks within a Route so they are sequenced as closely together as possible. The best way to understand the Compact command is by looking at an example. In the screenshot below, the Info panel shows 3 Task where Tasks 1 & 2 have a 3 hr spread and Tasks 2 & 3 are overlapping. Obviously, this is a non-optimal layout.

Clicking the Compact button on the Command Bar will re-jigger the series of Tasks on a Route by taking the ending time of the Task 1, calculating the drive time for Task 2, setting the start time for Task 2 equal to the end time for Task 1 + drive time to Task 2 and repeating for subsequent Tasks. You can also add “padding” to add extra time between Tasks to account for unpredictable drive times or as extra “margin.”

You can use the Compact button manually, or select the Auto-Compact checkbox on the Command Bar to automatically have a Route compacted when you make changes. If you have selected to start and end a Route at a depot the Map and Info Bar will reflect that.

Note: Arrivy will compact a route beginning from the start time of the first task of the day. The depot start time is set independently. You must make sure that you have allocated enough time to get from the depot to the first Task. 


The Publish Tasks & Routes command takes all of the adjustment to time, sequence and assignees made during a Route Planning session and makes those changes in the original Tasks. Thus, if your original Task was assigned to Eddies for 10:30 AM and through your Route Planning session was reassigned to Robben at 2:00 PM–the Publish action will copy those changes into the original Task. Once you have Published your routes, you cannot recover the previous times or assignments. You CAN do Route Planning on a set of Tasks that have already been Published. However, your starting point will be the previously Published Task times and assignments.

Normally, if you change the date or times of a Task, the customer will be sent an email and/or SMS message letting them know their Task has been rescheduled. This will also happen as soon as you Publish your routes (for all the Tasks that have time changes). However, you do have the ability to suppress these communications when you execute a Publish. When you click the Publish Tasks & Routes button, it brings up a dialog which lists all the Task changes. Additionally, the Publish changes without sending messages checkbox in this dialog let you suppress Task-rescheduled messages that would occur because of the Publishing changes.