Dispatch Forms to a User

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). a form when you want one or more specific users to get the form in their Inbox. You can prefill answers and add Notes, Priority, Due Date, and Location metadata to help users prioritize jobs. This topic describes how to dispatch a form from the Web Portal and how to bulk dispatch jobs to multiple users.

Available on all tiers:




Benefits of dispatching

In many cases, starting with a blank form just doesn’t make sense. You know in advance who should be filling out the form, and you know some of the data that belongs there. Dispatching allows an administrator to choose which mobile user should fill out a form and to provide important information about the task.

For example, you can direct a technician to a customer location and provide instructions about the work to be done. This can help mobile workers arrive prepared for their site visit so that they can get right to the task at hand.

Ways to dispatch a form

There are four ways to dispatch forms to users:

This topic describes the first two options.

Info:The topic Supported Question and Data Types for Dispatching lists the data and question types that each dispatch method supports. It also describes the formatting requirements for specific types of questions, such as Barcode Scanner and Geolocation.

Video demo

Dispatch a form with the Web Portal

We make it quick and easy to dispatch forms to users with the user-friendly dispatch interface.


Steps to dispatch a form

  1. Navigate to the desired form, and then select Dispatch beside the form name.

    Note:If you don’t see the Dispatch option, make sure the form is set up for dispatching.

  2. Select a user to dispatch to.

  3. Fill out any fields you want prefilled for the user. Leave all other fields blank.

  4. At the bottom of the page, select Dispatch.

Metadata that you can dispatch

Easily assign notes, priorities, due dates, and locations to dispatches, giving mobile users the tools they need to efficiently plan their work in the field. Your mobile users can get a higher-level look at their assigned jobs without needing to look at each individual form. Also, they can sort based on the metadata, right from the Inbox.

You can dispatch metadata into the following fields:

  • Notes: These can be a maximum of 256 characters.
  • Priority: This can be Low, Medium, or High. If you don’t assign a priority, the dispatch defaults to No Priority.
  • Due Date: If you don’t supply a time zone, the dispatch defaults to the dispatcher's team time zone.
  • Location: Enter an address. The Web Portal provides a map so that you can confirm the location.

Steps to dispatch metadata with the Web Portal

Use the additional boxes at the top of the dispatch page to fill in the metadata information. Simply add the information that you need—you don’t have to add all of the metadata.


Field users can find the notes under the dispatched form name in their Inbox.


The other types of metadata act as a filter when a user selects a tab at the top of the Inbox.

Dispatch an image

By dispatching an image, you can provide details about a job, such as a:

  • Site-specific floor plan.

  • Reference chart.

  • Sketch produced in TrueContext from an earlier site visit or job estimate.

Note:You can dispatch a .jpg, .jpeg, or .png file to an Image, Sketch Pad, or Signature question.

To dispatch an image, select Choose File.

Dispatch a language

Info: The Multi-Language feature is available as an add-on to the Advanced and Enterprise tiers. With the Multi-Language feature, you can create a single form and provide it to your field users in multiple languages. You can also set up some types of Documents and files to translate content based on the form’s selected language.

If you set up a form as a Multi-Language FormClosed A Multi-Language Form is a form that’s set up with different translations so that field users can choose their preferred language. Translated content includes page and section names, question text, help text, and other form content., you can preselect a language or let users select a language themselves. Translations for the selected language apply to:

Dispatch Form page that shows the Select Language list with the following options: All (user selects), English, Spanish. You can dispatch a language or let the user select. "All" refers to all of the languages that have translations set up on the form.

Tip: If you dispatch a form with a preselected language, choose one that all users who interact with that form can understand.

Note:Dispatch Destinations do not give you the option to dispatch a language. The user selects a language when they open the dispatched form.

Bulk Dispatch with a CSV File

Need to dispatch forms to multiple users? Our CSV template allows you to bulk dispatch with a single upload.

  1. At the top of the dispatch page of the selected form, select Bulk Dispatch.

  2. Select the link to download the dispatch template.

  3. Starting with the first empty row, enter the user IDs for the users you want to dispatch to.

    Each row is a new dispatched form.

    Info:The topic Supported Question and Data Types for Dispatching describes how to format Barcode Scanner and Geolocation values for bulk dispatch.

  4. Enter the data and metadata that you want to dispatch.

  5. Does your team have the Multi-Language Forms add-on?

    • If no, go to step 6.

    • If yes, and you want to preselect a language, enter one of the supported language codes in the Language Code cell.

      Bulk Dispatch CSV file that shows "Language (Optional)", "Language Code", and "es" entered as the code.

      Note:Check that the form has a translation file for the selected language.

    • If yes, and you want users to select a language themselves, leave the Language Code cell empty.

  6. To upload the file that contains the dispatch information, select Choose File, and then select the file.

  7. Select Dispatch at the bottom of the page.

Info:The following topics provide more details about Bulk Dispatch functionality: