Dispatch Metadata and Inbox Views


Adding dispatch metadata gives your mobile users key information about the work to be done. This allows them to make more informed decisions about their assigned jobs. When metadata is dispatched, mobile users can easily see the notes, priority, due date, and reorganize by nearest location in their Inbox. This cuts down the time needed to choose a route for the workday, making your people in the field more efficient.

Available Inbox Views


The navigation bar appears in your Inbox when you have forms that have dispatch metadata. The tabs will only appear if you have forms in your Inbox that contain the appropriate metadata, e.g., if you have forms with location data, the Map view will show up, but not the Priority view. There are four possible views:

  • List
  • Due Date
  • Priority
  • Map

Filtering Your Inbox: What to do with Dispatch Metadata

As a team administrator, you can use any of these types of dispatch metadata to give your mobile users key information.

List View

The List view of the iOS app inbox.

The List view is the default Inbox view. You can use the Search to filter any results at need. The only dispatch metadata shown in the List view are Notes.

DispatchClosed The term "dispatch" refers to the act of sending a form to a mobile user or customer. Typically, a dispatched form includes some information pre-filled to give the recipient context for the work to be done. Dispatch can be manual or automated (using a Dispatch Data Destination or the TrueContext REST API). notes appear beneath the dispatched form's name. They appear in every Inbox view. Notes can be used for information such as:

  • worksite hours,
  • site-specific hazard warnings,
  • job instructions
  • location notes

Notes are limited to 256 characters, including spaces.

Due Date

The Due Date view of the iOS app inbox

This view shows the form with the nearest due date at the top. If no dispatched forms contain a due date, this view will not be shown. 

Any forms without due dates will be shown at the bottom. Due dates can contain:

  • A date
  • A date and time

Examples of using due dates are:

  • setting dates and times on site visits, so mobile users can plan their day and arrive on time, when customers are expecting them.
  • an actual due date, such as for timesheets on Friday at 6PM, or monthly inspections on the last day of the month.

This view is also searchable to further filter results if needed.


The Priority view of the iOS app inbox.

The Priority view appears if your inbox contains dispatched forms with priorities set. If your inbox does not contain any forms with a dispatched priority, this view will not be shown.

Dispatchers can set three priorities: Low, Medium, and High. High priority dispatches will be shown at the top of this view, followed by Medium priority dispatches, and then by Low priority dispatches. Dispatches with no priority will be shown at the bottom. An example of using priorities is:

  • dispatchers rerouting a repair truck by dispatching a high priority repair request straight to their inbox, complete with location data and notes.

The full date and time are shown beneath the dispatch notes for the dispatched form.


The Map view of the iOS app inbox.

This view plots all the dispatched forms with location data on a map. If your inbox does not contain dispatched forms with location data, this view will not be shown.

Standard gestures allow you to zoom in and out on the map. When selected, the pins show the dispatch notes and two options:

  • Open the dispatched form.
  • Provide driving directions. This will open the default map app on the mobile device and provide driving directions from the mobile user's current location. This is supported in TrueContext for iOS 8.2.1, and coming soon on TrueContext for Android 7.5.

Some common uses of this view are:

  • mobile users planning their route for the day based on distance and transport times.
  • dispatchers rerouting a repair truck to a nearby location using a combination of location data, a high priority dispatch, and notes on the work to be done.

A banner at the bottom of the map will display how many dispatched forms do not have location data.

Where to Find Metadata on Form Submissions

Web Portal

To look at your dispatched metadata for any data record:

  1. Navigate to the Data page.

  2. Select the desired form submission.

  3. Find the Dispatch MetadataClosed Dispatch metadata is additional information that helps users prioritize their work. Dispatch metadata includes job notes, priority level, due date, and location. Admins can combine any number of these items when they dispatch a form. Users see this information when they check their Inbox. header. All your dispatched metadata will be found beneath this header.


How to Dispatch into Metadata: Documentation

For detailed instructions on how to dispatch into metadata, please find your preferred method of dispatching below: