Understand Image Field | Zoho Creator Help

Understand image field

  1. When accessed via your iOS devices' browsers, you can upload images and attach image URLs but you cannot capture them via the image field. This is because media objects are not supported by iOS.
  1. When accessed via Safari browser, you can upload images and attach image URLs but you cannot capture them via the image field. This is because media objects are not completely supported in Safari.

The image field enables your users to submit an image through your form. They can either take a photo or upload one. The following is how an image field looks on a form:

  • When a user accesses from a web browser:

  • When a user accesses from a phone or tablet:

Size limits

  • When a user accesses from a web browser and uploads an image from the device's local storage, the image field can accept an image up to 10 MB
  • When a user accesses from an iPhone or iPad device and uploads an image from the device's local storage, the image field can accept an image up to 5 MB
  • When a user accesses from an Android device and uploads an image from the device's local storage, the image field can accept an image up to 5 MB

The images that your users submit through your form are stored in your account and are counted towards your account’s total storage limit. Visit your account's  usage details  page to view its current storage details.

Uploaded image's name

When your users upload an image to this field, the image's name is set in the following format:

<unique_number>_<uploaded_image_name>
  • The image's name is prepended by an underscore (_) and a system-generated number that uniquely identifies that image in your account
  • The image's name will automatically be trimmed when it exceeds 150 characters
  • Whitespaces and other special characters, excepting hyphens (-), will be replaced by an underscore (_).

On accessing from a web browser

The following is an example of how an image field looks when a user accesses from a web browser.

Subject to the  browse options  you enable for your field, your users can upload an image:

To upload an image from local storage

  1. Click the  Upload  icon in the image field. This will launch the device's file explorer.
  2. Select the required image.
  3. Alternatively, you can drag and drop the required image onto the field.
  1. Click the  URL  icon in the image field.
  2. Enter the required image's URL.
  3. If the  image options  have been enabled for the image field, enter a  Link Name  and  Title  for the image URL you entered.

Take a photo using the device's camera

  1. Click the  Camera  icon in the image field.
  2. If it is the first time your user is accessing the image or video field, they will be prompted to grant permission to use the device's camera:
    • They can either  Allow  or  Block
    • If they select  Block , they will be prompted with the message  Allow access to media . They won't be able to take a photo till they  Allow  access to the camera.
  3. Click  Allow . This will launch the image recorder in a pop-up window.
  4. Click the  Camera  icon at the bottom of the pop-up, to take a photo.
  5. Click  Done  to use the photo, or click  Retake  to retake the photo and then click  Done .
  6. The photo you took will appear in the image field.

On accessing from a phone or tablet

When your users access your form from a phone or tablet and tap on the image field, they can add an image in two ways:

Additionally, users of iOS13 and later can scan multiple images and upload them as a PDF to the  file upload  field.

Take a photo

  1. Tap on the image field. This will launch the device's primary or secondary camera, depending on what value the  Default Camera  field property is set with.
  2. If the  Enable photo gallery  field property is enabled, tap  Take Photo . This will launch the device's camera.
  3. If the  Allow to Switch Camera  field property is enabled, you will be able to switch between the device's cameras.
  4. Take a photo by tapping the  Shutter  button. You will get to preview the image you took.
  5. Tap  Use Photo  at the bottom-right corner of the screen, or tap  Retake  at the bottom-left corner to retake the image.
  6. If the  Annotation (for mobile)  field property is enabled, you will get to add annotations to the image.
  7. Click  Done  at the top-right corner of the screen. The photo you took will appear in the image field.
  1. Tap on the image field, then tap  Choose Photo . This will launch the device's photo gallery.
  2. Select the required image.
  3. If the  Annotation (for mobile)  field property is enabled, you will get to add annotations to the image.
  4. Tap  Done  at the top-right corner of the screen. The photo you selected will appear in the image field.

Field properties

You can also perform the following customizations for the user experience of the image field on your form:

Downloading images

URL to download an image

Note : This URL works for images that are either uploaded from local storage or captured using the device's camera

An image stored in the image field can be downloaded using the following URL:

https://<domain>/<account_owner_name>/<appLinkName>/<reportLinkName>/<fieldLinkName>/download/imageName

where,

  • domain  will be DC specific—for example, you'll need to use  creatorexport.zoho.com  if your account is in Zoho's US data center, and  creatorexport.zoho.eu  if in the EU data center.
  • account_owner_name  contains the user name of the Creator application's account owner and the link name of the application.
  • reportLinkName  is the link name of the report where the corresponding image field is displayed. (To know the report link name, click on  Report Settings ->Summary  from the edit mode of the report to get the reportLinkName).
  • fieldLinkName  is the  link name  of the corresponding image field. 
  • imageName  is the corresponding image's name.  Learn more

For example, imagine that you've built an application named  Zylker Automobile Service . In this application, you have created a form named  Emergency service request , where users can capture the picture of their damaged vehicle, add a description for the image and submit the form. When you access the  Emergency service request  report, you may want to download the images. To do this, you can configure a custom action in your report, such that when you click the button  Download image , the image gets downloaded. This custom action has the above URL format constructed as follows:

tempFilename = input.<fieldLinkName>.getsuffix("image/");
tempFileName = tempFileName.getprefix("\" lowqual");
openURL = (" https://creatorexport.zoho.com" + zoho.appuri + "<reportLinkName>/<fieldLinkName>/download/" + tempFileName, “window type”); 

where,

  • tempFileName  is a variable that stores the filename of each image stored in the image field
  • getsuffix() returns all the characters which follow the first occurrence of searchString in the string.  Learn more
  • getprefix() returns all the characters which precede the first occurrence of searchString in the string.  Learn more
  • zoho.appuri  returns the application details in the format:
     /<account_user_name>/<application_link_name>
  • The  openUrl  Deluge task is used to redirect the user to the specified URL. This URL can be opened in the same window, new window, parent window, popup window, or iframe

Now, when you access the  Emergency service request report,  you can see the  View image  button:

In the above image, Megan is the <account_user_name> and zylker-automobile-service is the <application_link_name>

Tip: This URL format can be used to download files from the file upload, image, audio, video and signature fields

Download images in bulk using the file download tool

Note :
  1. The file download tool supports downloading of files from file upload, image, and signature fields as of now. You cannot download the files if these fields are in a subform inside the parent form.
  2. This tool is currently only supported for Windows.
  3. Ensure that you have ten or fewer authtokens in your accounts.zoho.com to avoid any username or password-related errors

Zoho Creator provides a tool that enables you to download all the images stored in an image field, at once. To use this tool:

  1. Download the tool and run it. Ensure to download the right tool:
    As  announced  recently, this tool will be completely phased out by November 30, 2020. Please reach out to us at  support@zohocreator.com  for file download related queries.
  2. Enter your Zoho Creator account credentials and click on  Sign in

  3. Alternatively, you can use a pre-generated  application-specific password  and the email address used to log in to your Zoho account to sign in to the filedownloader.exe tool.
  4. Select the required  Application Name . This is the application containing the uploaded files.
  5. Select the required  View Name . This is the report in the specified application containing the files.
  6. Enter the  Field Deluge Name . This is the field link name of the required file upload field. Click on the " ? " icon to view field deluge names in your applications.
  7. Specify the  Local Folder Path . This is the folder where your files will be saved.
  8. Click  Download.

Once all the images have been downloaded, a success message will pop up. The downloaded images will be stored in the folder specified in the tool.


Related Topics:
  1. Mobile properties
  2. Image properties


    Zoho CRM Training Programs

    Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.

    Zoho CRM Training
      Redefine the way you work
      with Zoho Workplace

        Zoho DataPrep Personalized Demo

        If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.

        Zoho CRM Training

          Create, share, and deliver

          beautiful slides from anywhere.

          Get Started Now


            Zoho Sign now offers specialized one-on-one training for both administrators and developers.

            BOOK A SESSION








                                You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.




                                    Manage your brands on social media

                                      Zoho Desk Resources

                                      • Desk Community Learning Series


                                      • Digest


                                      • Functions


                                      • Meetups


                                      • Kbase


                                      • Resources


                                      • Glossary


                                      • Desk Marketplace


                                      • MVP Corner


                                      • Word of the Day


                                        Zoho Marketing Automation

                                          Zoho Sheet Resources

                                           

                                              Zoho Forms Resources


                                                Secure your business
                                                communication with Zoho Mail


                                                Mail on the move with
                                                Zoho Mail mobile application

                                                  Stay on top of your schedule
                                                  at all times


                                                  Carry your calendar with you
                                                  Anytime, anywhere




                                                        Zoho Sign Resources

                                                          Sign, Paperless!

                                                          Sign and send business documents on the go!

                                                          Get Started Now




                                                                  Zoho TeamInbox Resources



                                                                          Zoho DataPrep Resources



                                                                            Zoho DataPrep Demo

                                                                            Get a personalized demo or POC

                                                                            REGISTER NOW


                                                                              Design. Discuss. Deliver.

                                                                              Create visually engaging stories with Zoho Show.

                                                                              Get Started Now







                                                                                            You are currently viewing the help articles of Sprints 1.0. If you are a user of 2.0, please refer here.

                                                                                            You are currently viewing the help articles of Sprints 2.0. If you are a user of 1.0, please refer here.



                                                                                                  • Related Articles

                                                                                                  • Understand OCR field

                                                                                                    The OCR field enables you to perform optical character recognition on an image. In other words, it extracts text from the images stored in an image field. For example, you can use the OCR field to extract the text from the images of invoices, ...
                                                                                                  • Understand object detection field

                                                                                                    The Object Detection field determines the objects present in the pictures stored in an image field of your form. It uses Zoho's Artificial Intelligence (AI) to identify the type of objects present in an image. This field will store the output as a ...
                                                                                                  • Understand Section Field

                                                                                                    Understand Section Field The section field enables you to arrange the fields in your form in sections, and thereby provide your users a visual grouping of fields. Below image shows three section fields titled General, Group Status Details, and ...
                                                                                                  • Understand URL field

                                                                                                    Understand URL field The URL field enables your users to enter a URL (Uniform Resource Locator) - the link to a website or web page. Below is how a URL field looks on a form: When a user accesses from a web browser: When a user accesses from a phone ...
                                                                                                  • Understand AR field

                                                                                                    Understand AR field AR field displays the AR sets (3D models) from the AR library in your form as a dropdown. You can choose a model from either marker-based or markerless AR sets , and annotate it. Annotation helps in understanding the model better ...
                                                                                                    Wherever you are is as good as
                                                                                                    your workplace

                                                                                                      Resources

                                                                                                      Videos

                                                                                                      Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                                                                      eBooks

                                                                                                      Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                                                                      Webinars

                                                                                                      Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                                                                      CRM Tips

                                                                                                      Make the most of Zoho CRM with these useful tips.



                                                                                                        Zoho Show Resources