Set image properties for image field

Refer to this page to learn about the Image field

The image field allows you to perform the following customizations for the user experience of the image field in your form:

• Aspect ratio
  
• Compression
• Browse options
• Image options
• Mobile properties

Set aspect ratio

1. Edit your app.
2. Open the required form's builder.
3. Select the required image field. Its  Field Properties  will appear on the right.
4. Select the required value from the dropdown below  Aspect ratio . The picture your end user uploads or captures will be resized to this ratio.
   

   

Below is how images added in the image field will look in a report with an aspect ratio of  3:2 .

Enable image compression  

The image files that users upload in your form can be compressed in good resolution by enabling the Image Compression field property for the image fields. This facilitates uploading larger images without depending on any third party tools to compress the image.

1. Edit your app.

2. Open the required form's builder.

3. Select the required image field. Its Field Properties will appear on the right.

4. Under the Compression section, tick the Compress image checkbox.
   
   

After enabling this property, any image files uploaded will be compressed and stored as compressed files in JPEG format. When accessing the reports, only the compressed images can viewed and downloaded. The original images will not be retained.

Points to Note:

1. By default, uploaded images will be compressed to a dimension of 2560 pixels.
   
2. The supported image types for compression include .jpg, .jpeg, .png, .gif, .svg, .tiff, .bmp, .psd, .webp, and .heic.  If other type of files are uploaded or if the compression fails, the original file will be stored without compression.
   
3. While PNG image inherently preserves transparency, after compression the transparency will not be retained as it is converted to JPEG format.

1. Compression will be applied only when the images are uploaded through forms or added via upload file API. Compression won't be applied if the image is added through deluge statements like Insert tasks.
   
2. Compression will be applied to images that are uploaded from your local storage or captured via device cameras. If you specify the image address URL, compression will not be applied and the link will be stored as such.
   

3. Images uploaded after the release of the image compression feature on December 11, 2023, will be compressed provided the Compress image property is enabled; Previously uploaded images will remain uncompressed.

Set browse options

1. Edit your app.
2. Open the required form's builder.
3. Select the required image field. Its  Field Properties  will appear on the right.
4. Check the required  Browse Options :
   
   • Check  Local computer  to allow the end user to upload an image from their device's local storage (photo gallery in case of mobile devices)
   • Check  Link  to allow the end user to enter the URL of an image stored in the cloud
   • Check  Camera  to allow the end user to capture an image using their device's camera
     

     

Set image options

1. Edit your app.
2. Open the required form's builder.
3. Select the required image field. Its  Field Properties  will appear on the right.
4. Check the required  Image options :
   
   • Title : The title allows your users to enter additional information about the URL they input, which is displayed as a tooltip in reports.
   • URL : Link name allows your users to define the landing page URL(the webpage where your users will be redirected to after clicking an image in your report) for the image they add in the image field. 
     

     

Take a look at the following example of an image field that accepts an input for the image's  title  and  URL  in the browser: 

The below image shows how a  title  for the image field in a report looks:

Related Topics

1. Understand image field
2. Set mobile properties