The Embedded Photo field shows an image on the form, such as a logo, a diagram, or an example of a finished job. This article covers how to add an Embedded Photo field, upload its image, and configure its settings.
How the Embedded Photo field works
An Embedded Photo field displays a fixed image that's part of the form. Users see the image, but they can't replace it.
For example, an inspection form can show a wiring diagram so technicians know what a correct installation looks like.
You can also let users draw on the image, for example to circle damage on an equipment diagram. Learn more about adding a sketch or annotation field.
Add an Embedded Photo field
In the Form Builder, select Add Fields in the side bar.
Under Multimedia, select Embedded 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 Embedded Photo Field, and its field settings open on the General tab.
Upload the image
In Field Label, enter the name users see, for example Wiring Diagram.
Under Image, select Upload Photo, then choose an image file.
In Quality, select the image quality. Choose PNG for diagrams and line drawings.
To limit the image size on the form, enter a value in Max Height (px) or Max Width (px).
To replace the image, select Re-Upload. To open it in a new tab, select View. To remove it, select Delete.
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 name users see on the form |
General | Field Key | The key that identifies the field in submissions, rules, and calculations |
General | Image | The image shown on the form |
General | Quality | The image quality: Jpg Normal, Jpg Medium, Jpg High, or PNG |
General | Allow Annotation | Lets users draw on the image |
General | Max Height (px) | The largest height of the image on the form. The width scales to match |
General | Max Width (px) | The largest width of the image on the form. The height scales to match |
General | Required Field | Users must complete the field before they can submit the form |
Behavior | Hide Field | Hides the field in the app |
Behavior | Hide Field Label | Shows the image without the field label |
Behavior | Exclude From Reports | Leaves the image out of reports. It stays in the submission data |
Behavior | Exclude Sync | Leaves the image out of the submission data and reports |
Behavior | Enabled | When off, the field is grayed out and users can't change it |
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 |
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.
Add the field with the Assistant
You can also ask the Assistant to add an Embedded Photo field.
Select Assistant in the side bar.
Describe what you want, for example Add an embedded photo field called Wiring Diagram after Description, and let users annotate it.
Send the message.
The Assistant can add the field and turn annotation on or off. It may also change the quality. It can't upload the image, so select Upload Photo in Field Settings to add it.
Note
Assistant changes aren't saved until you select Save Draft.