Skip to main content

The Photo field

Collect photos and configure their quality, data overlay, display and export tag.

Overview of the Photo field

The Photo field lets you take a photo with the mobile device or import one from the gallery. In Web entry, taking a photo is not available: the user can only insert a photo from their computer. It belongs to the Media category, along with Voice Recorder, Drawing, Sketch, Attached file and Signature.

Adding the field to a form

On the form creation screen, whether the form is new or existing, the field catalog on the left groups the fields into nine categories. Only one category is open at a time: click its name to open it. The Photo field is in the Media category, in first position. Hovering over the field displays a short description.

There are three ways to add the field:

  • Click Photo: the field is inserted just after the selected field. If no field is selected, it is added at the end of the form.

  • Drag and drop it from the catalog to the desired location. While you drag, the insertion areas are shown with a dotted outline.

  • The + button that appears below the hovered or selected field: it opens a menu with a search bar to insert a field at that exact spot.

As soon as the field is added, its title switches to edit mode: type its name and confirm with the Enter key. To rename it later, double-click its name. The mobile Preview updates with every change.

Accessing the field options

In the editing area, double-click the field or click the pencil icon (Edit). The options are displayed as cards.

They appear in this order: Essentials, Photo, Data overlay, Visibility conditions, Display & layout and Advanced, followed by the Technical identifier.

There is no confirmation button: each setting is applied immediately, and āœ“ Modified is displayed after each change. To move around the options:

  • Undo (the arrow at the top) or Ctrl+Z: goes back one step.

  • ↑ and ↓ in the header: move to the previous or next field without returning to the form.

  • Back (the arrow at the top left): closes the options and returns to the form.

ā„¹ļø Good to know
Only the Save button saves the form permanently. Until you save, nothing is sent to mobile devices.

While the options are open, the catalog is greyed out. Close them to add a new field.

Essentials

This card contains the basic settings of the field.

  • Field title: by default, it is the name of the field type ("Photo"), but you can change it.

  • Choose an icon (the button to the left of the title): displays an icon in front of the field title, in the mobile app as well as in Web entry. Icons are grouped by theme (Statuses & alerts, Arrows & navigation, People & gender, etc.) and a search is available. No icon removes the icon.

  • Required entry: when this option is enabled, the user must fill in the field before submitting the form. The asterisk shown next to the field title, in the editing area, also lets you enable or disable it.

  • Multiple photos: allows the user to take several photos in the same field. Once the option is enabled, the Minimum number of photos and Maximum number of photos options appear in the Photo card.

  • Help text shown on mobile: enter an instruction for your users. During data entry, they can view it by tapping the question mark shown to the right of the field title.

Photo

This card, titled Quality and limits, sets the size, orientation and name of the photos.

  • Max. photo size (px): maximum size of the photos, up to 4000 px. The default value, 768 px, ensures good quality while keeping photos lightweight, especially when exports are sent by email.

  • Minimum number of photos and Maximum number of photos (if Multiple photos is enabled): a minimum of 1 is the same as a required entry. It is recommended to set a maximum to avoid too large a volume of data.

  • Enforced orientation: No, Portrait or Landscape. If the photo is not taken in the enforced orientation, a message is displayed and the photo cannot be confirmed. This option only works with the Kizeo Forms camera: it has no effect on photos imported from the mobile device's gallery.

  • Customise the export name for photos: name given to the photos in exports (media zip, clickable images in PDF and Excel, links in Excel list). You can use your form's tags, up to 150 characters.

Data overlay

This card adds information as a watermark on the photos.

  • Data to overlay: click Date and time, GPS coordinates and/or Address to overlay them at the bottom right of the photo. Selecting GPS coordinates automatically enables the next option.

  • Collect geolocation data: the GPS position is collected when the photo is taken. In your custom export templates, you can then add the suffixes :latitude, :longitude and :altitude to the field's tag.

āš ļø Important
Data overlay only works with the Kizeo Forms camera: it disables the option to import a photo from the mobile device's gallery.

The Photo field offers the same options whether it is placed in a table or not.

Visibility conditions

Three modes are available:

  • Always visible: the field always appears when entering data.

  • Visible if…: the field is displayed only when the conditions you define are met.

  • Always hidden: the field is never displayed during data entry, but remains usable in exports.

For details on setting up conditions, see the Visibility conditions tutorial.

Display & layout

This card customises how the field is displayed.

  • Title colour: choose from the colours offered. The first option, crossed out, means no colour. The colour applies in the mobile app as well as in Web entry.

  • Field title size: move the slider between Aa (smaller) and Aa (larger). The preview shows the resulting size in pixels (11 px by default). This size only applies in the mobile app.

  • On the same line as the previous field: this option places the field next to the previous one, in the mobile app only. It requires enabling the Allow multiple fields to be displayed on one line option in the mobile app settings.

Advanced

  • Do not save to the gallery: the photo stays attached to the form, but does not appear in the device gallery.

  • Read-only when editing: the field stays visible, but can no longer be edited when the record is reopened for editing.

  • Personal data (GDPR): this option flags the field as personal data. Its content is then partially masked in the data history: only the last 3 characters remain visible. Clicking the eye icon shows the data in clear: anyone with access to the data can therefore still view it in full.

  • Word: remove the line if empty: in a Word export, the paragraph containing the field's tag is removed if the field is empty.

    To learn more, see the Block tags and paragraph deletion tutorial.

Technical identifier and tag

Below the advanced options, the Technical identifier field shows the identifier of the field. It is used as-is in calculations and automations.

The tags to use in your custom exports are shown just below. Clicking a tag copies it.

The tags shown depend on the Multiple photos option:

  • if the field is single, only the ##photo## tag is shown;

  • if the field is multiple, the ##photo## tag appears first, followed by one tag per photo (##photo:1##, ##photo:2##, etc.). Insert as many numbered tags in your export template as there are photos to display.

Photo

Tag

Photo 1

##photo:1##

Photo 2

##photo:2##

Photo 3

##photo:3##

Following photos

##photo:4##, ##photo:5##…

Tags are always enclosed in two hash signs (##). To customise them to your needs, see the Using tags to customize exports tutorial.

šŸ’” Tip

The technical identifier, and therefore the tag, can only be changed as long as the form has not been saved. It is recommended to customise it before the first save.

Did this answer your question?