Single Photo Field

Prev Next

The Single Photo field lets users take or upload one photo as part of a form. This article covers how to add a Single Photo field, set how photos are captured, and configure its settings.

How the Single Photo field works

A Single Photo field shows a Take Photo button in the FastField mobile app. The user takes a photo with the camera or picks one from the photo library. The app adds it to the submission.

For example, a work order can ask for a Before Photo of the equipment. The photo shows the condition of the equipment before any work started.

To collect several photos in one field, use a Multi Photo field instead.

Add a Single Photo field

  1. In the Form Builder, select Add Fields in the side bar.

  2. Under Multimedia, select Single Photo to add it after the selected field. You can also drag it onto the canvas where you want it.

The field appears on the canvas as Single Photo Field, and its field settings open on the General tab.

Set how photos are captured

Use Single Photo Settings on the General tab to control where photos come from and how they're saved.

  1. In Field Label, enter the question users see, for example Before Photo.

  2. Turn on Allow Camera, Allow Photo Library, or both, to choose where users can get the photo. A new field allows the camera only.

  3. In Quality, choose Jpg Normal, Jpg Medium, Jpg High, or PNG.

  4. Turn on any other settings you need, such as Allow Annotation or Photo Overlay Date/Time Stamp.

Tip

Lower quality and a smaller Max Height (px) or Max Width (px) make submissions upload faster.

Configure the field

Use the General, Behavior, and Appearance tabs in Field Settings to control how the field works.

Tab

Setting

What it does

General

Field Label

The question users see on the form

General

Field Key

The key that identifies the field in submissions, rules, and calculations

General

Allow Camera

Lets users take a photo with the device's camera

General

Allow Photo Library

Lets users upload a photo from the device's photo library

General

Quality

The image quality of the saved photo

General

Allow GPS Tagging

Saves the GPS coordinates of where the photo was taken in the photo's data

General

Allow Annotation

Lets users draw on the photo. Learn more about sketch and annotation

General

Photo Overlay Field Key

Places the value of another field on top of the photo. Enter that field's key

General

Photo Overlay Date/Time Stamp

Places the date and time the photo was taken on top of the photo

General

Max Height (px) and Max Width (px)

Resizes photos so they're no larger than these sizes, in pixels

General

Image Name

Names the image file for downloads and workflow delivery. You can include field keys wrapped in $, for example $repairType$ photo

General

Required Field

Users must add a photo before they can submit the form

Behavior

Hide Field

Hides the field in the app

Behavior

Hide Field Label

Shows the field without its label

Behavior

Exclude From Reports

Leaves the photo out of reports. It stays in the submission data

Behavior

Exclude Sync

Leaves the photo out of the submission data and reports

Behavior

Enabled

When off, the field is grayed out and users can't add a photo

Behavior

Capture GPS Location

Records the GPS coordinates from when the field was last changed

Behavior

Capture Timestamp

Records the date and time the field was last changed

Behavior

AI Photo Insights

Lets users run AI analysis on the photo and get structured results. Shows only if your account has AI Photo Insights

Appearance

Background Color

Gives the field a color. Learn more about alert types

Select Save Draft to save your changes. Users see them after you select Publish.

Set up the field with the Assistant

You can also ask the Assistant to add a Single Photo field or change its settings.

  1. Select Assistant in the side bar.

  2. Describe what you want, for example Add a single photo field called Before Photo after Description. Turn on annotation and set the quality to Jpg High.

  3. Send the message.

The Assistant can add, rename, and move the field. It can also set the quality, camera, photo library, annotation, and date/time stamp settings.

Note

Assistant changes aren't saved until you select Save Draft.

What's next