Media and files

The following question types allow users to capture or upload media and files.

Image

Image provides a button to choose an image file from the device or take a photo using the device's camera if one is available. You can prevent the user from submitting an image file from the device by selecting Camera only as the image source. You can also allow the user to submit multiple images in one question response, up to a maximum of 99.

Caution:

If an image question contains multiple images, EXIF data cannot be extracted from the images. If you need to extract EXIF data from multiple images submitted to the same question, consider using a repeat.

This question type behaves in the same way as an image question in Survey123 Connect.

File upload

File upload provides a button to choose a file from the device. The Validation section allows the survey designer to define the allowed file types, first by category (Document, Archive, or a custom selection) and then by either a checklist or a comma-separated list of file name extensions. You can allow the user to submit multiple files in one question response, up to a maximum of 99.

This question type behaves in the same way as a file question in Survey123 Connect.

Audio

Audio provides buttons to record or upload an audio file. The Validation section allows the survey designer to define the maximum duration of the audio files recorded or to specify it as a required question.

This question type behaves in the same way as an audio question in Survey123 Connect.

Signature

Signature provides a free drawing field to provide a signature. This signature will be saved as an image and added to the survey response as an attachment. The only additional option available for this question type is to specify it as a required question.

This question type behaves in the same way as an image question with a signature appearance in Survey123 Connect.

Keywords

Survey123 uses attachment keywords to associate attachments with specific questions in a survey. When you create an image, audio, or file question in a survey and publish it, the question name is used as the keyword in the attachments table. For example, if a survey contains image questions called image_closeup and image_wideview, the value stored in the KEYWORDS column of the attachments table will be either image_closeup or image_wideview for each photo. Survey123 automatically matches the attachment keyword with the question name to associate attachments to questions.

The purpose of the keyword association is most evident when printing reports, Survey123 will ensure the correct photo is printed as a response to the correct question in the survey. Keyword association is also used to allow editing Images in the inbox.

If you change the name of an image question and republish the survey, you must also change the keyword for any existing attachment records.

Caution:

When Survey123 data is exported, the KEYWORDS column of the attachments table will not be retained.

If this data is then republished as a hosted feature service, you have one image question, and default filenames have been used for attachments, you can use the Update attachment keywords Python notebook to re-populate the KEYWORDS column. If you have more than one image question in your survey, you cannot use the notebook and must manually determine which file is associated with which question and enter the question name into the KEYWORDS column for each attachment record. For more information, see this Technical Support article.

If the data is republished as an ArcGIS Server feature service, you must first add the KEYWORDS column to the attachment table. You can use the Upgrade Attachments tool to add this column. If you have one image question, and default filenames have been used for attachments, you can use the Update attachment keywords Python notebook to re-populate the KEYWORDS column. If you have more than one image question in your survey, you cannot use the notebook and must manually determine which file is associated with which question and enter the question name into the KEYWORDS column for each attachment record. For more information, see this Technical Support article.

In either environment, when you next view these records in Survey123, the keyword value in the attachment table will match the question name, and the association will automatically be made.