Skip To Content

Media

Adding images and audio to your surveys can provide clear instructions and detailed references for your users. You can also capture images and audio in your surveys to provide information that would be difficult to communicate otherwise.

Images

To be included in your survey, all images must be saved in the media subfolder of your survey project.

Images can be added to any question by including the exact file name of the image file (including the file extension) in the media::image column of your survey worksheet. Use a note question to display an image that is not associated with a question.

To include images for multiple choice questions, add the media::image column to your choices worksheet. Add the exact file name of the image file (including the file extension) for each choice in this column. Set the appearance of the multiple choice question to minimal to display the images only.

Note:

Survey123 is case sensitive. Ensure all references to file names and their extensions use the same case as the actual files. For example, Tree.JPG is not the same as tree.jpg, and if referenced like this, the image would not display in your survey.

Selecting an image in a survey presents a full-screen view of the image. Return to the survey using the back button in the upper-left corner.

An image can also be submitted in your survey using an image question. This allows you to submit either an image saved on your device or a photo taken with your device's camera.

A photo taken in Survey123 will be saved as a .jpg file, with a quality level dependent on your device's camera. You can set the desired image size on the Settings > Images tab in Survey123 Connect. The following four options are available:

  • Small is 320x240 for a 4:3 photo, 320x69 for a panorama photo, and 320x320 for a square photo.
  • Medium is 640x480 for a 4:3 photo, 640x137 for a panorama photo, and 640x640 for a square photo.
  • Large is 1280x960 for a 4:3 photo, 1280x734 for a panorama photo, and 1280x1280 for a square photo.
  • Unrestricted allows any photo size to be attached to the survey.

By default, image size is set to Medium. Submitted images that were saved on the device keep their original file type, resolution, and quality.

Image questions also have alternate appearance types to annotate photos, draw on a canvas, or pen a signature. For more information on these, see Appearance.

Audio

To be included in your survey, all audio files must be saved in the media subfolder of your survey project.

Audio can be added to any question by including the exact file name of the audio file (including the file extension) in the media::audio column of your survey worksheet. Use a note question to play an audio clip that is not associated with a question.

To include audio for multiple choice questions, add the media::audio column to your choices worksheet. Add the exact file name of the audio file (including the file extension) for each choice in this column.

When audio is included in a survey, a speaker button will be active on the form. Press this button to play the audio file. Audio files can be played repeatedly.

An audio clip can also be captured in your survey using an audio question. This captures an audio file using the default audio capture method for your device.

Audio responses are limited to two minutes in length. Survey123 records at a 22010 Hz sample rate in mono, and the audio is stored as a lossless .wav file, which means that a maximum-length audio file is about 5 MB in size. Audio quality will vary depending on your device but will typically be of an acceptable level for speech recordings.


In this topic
  1. Images
  2. Audio