Gallery Field

Gallery Field

The Gallery Field is an advanced, repeatable field type that allows users to upload, capture, and manage multiple images within a single entry.

Using the Gallery Field

Key Features

  • Multi-Upload: Add up to 6 images at once from a device gallery, or capture them sequentially with the camera.
  • Sub-Fields: Nest additional fields (such as Text, Number, or Location) within the Gallery to capture metadata for each image.
  • Pagination: If more than 6 images are added, the app automatically generates navigation arrows for easy browsing.
  • Repeatable Logic: Like Tables or Pages, the Gallery is a repeatable field. This structure is essential for data output and templating, and can also use repeat formulas.

Setting Up Default Captions

You can streamline data entry by prompting users to add a caption immediately after they upload or capture an image.

Step-by-Step Configuration:

  1. Add the Gallery Field to your form designer.
  2. Nest a Text Field: Drag a Text field inside the Gallery field and give it a unique Data Name (e.g., caption_default).
  3. Enable the Prompt: In the Gallery Field’s Basic Properties, check the box for Prompt User for Default Caption.
  4. Link the Data Name: Enter the Data Name of your Text field (caption_default) into the property field.
  5. (Optional) Add additional fields, such as “Comments” or “GPS,” within the Gallery to capture more context per photo.

Note: When this is active, users will see a pop-up immediately after image selection or capture, ensuring no image goes uncaptioned.

Populating from a Data Source

The Gallery field can also act as a viewer for existing images stored on the platform, rather than just a capture tool.

  1. In the Gallery Field Properties, enable Populate from Data Source.
  2. Select the Data Source containing your images.
  3. Bind the Media Field: Map the Gallery’s internal media field to the specific image column in your data source.

Data Source Image Columns

Performance Considerations

By default, the app displays the first 30 rows from a Data Source. While you can increase this limit, we recommend testing on low-end devices first to ensure the app remains responsive.

Outputting Gallery Data (Templates)

Because the Gallery is a repeatable field, you must use specific syntax to display its contents in custom Word or Excel reports. You must encase the data name placeholders in a REPEAT loop.

Repeatable Data in Templates

Example: Displaying 3 Photos per Row

If you want to output three images and their captions side-by-side, use the following structure in your template:

{{!REPEATSTART|3}}

{{gallery1_media}}




{{gallery1_media}}




{{gallery1_media}}




{{caption_default}}{{caption_default}}{{caption_default}}

{{!REPEATEND}}

Technical Tip: Ensure your REPEAT placeholders precisely match the Data Names assigned within your form builder to avoid broken links in your generated documents.

    • Related Articles

    • OCR Field

      The OCR (Optical Character Recognition) Field type lets you convert written or printed information into text via your device’s camera. This premium feature allows a user to capture or upload an image and rapidly convert any text found in the image ...

    • Media Field

      Our Media Field allows for displaying and capturing photos, video, and audio in-app. Images captured can be watermarked with custom text from field-captured data to retain context after submitting, and overlays can be used to ensure consistent ...

    • Attach Field

      The Attach field is an advanced field type that allows documents or files (up to 25MB) on a user’s device to be added to a form as an attachment for output. Alternatively, a file can be downloaded from a specified URL. Attached PDF’s can also be ...

    • Section Field

      The Section field is a read-only field type that allows you to display static or dynamic text and/or images. These texts or images could provide additional information or instructions to aid the user in completing their task. The section header can ...

    • Choices Field

      In our system, the Choices field is like a Swiss Army Knife – it is a multi-purpose field that enables displaying sets of choices in various ways. As such, Choices fields have a few configurable properties, which can be overwhelming if you try to ...