Question types

The table below describes the question types that are available in all Survey123 component apps (Survey123 Studio, Survey123 Connect, Survey123 Mobile, the web designer, field app, and web app).

For some question types, there are differences in behavior and implementation across platforms; for the differences, refer to the notes after the table.

XLSForm question type	Survey123 web designer question type	Description
audio^4	Audio ^4	Record an audio clip in the field app. Record an audio clip or use an uploaded audio file in the web app.
barcode	Barcode	Scan a barcode or QR code.
begin group	Group, Page	Begin a group of questions.
begin repeat	Repeat	Begin a set of repeating questions.
calculate	N/A	Perform a calculation on values in the form. The calculate field contains the outcome of the calculation.
decimal^1	Number^1 ^6	Decimal input.
date	Date^6	Date input.
dateTime	Date and time^6	Date and time input.
deviceid^7	N/A	The UUID representing the specific device on which the survey was taken.
email^2	N/A	When signed in with an organizational account, this question is automatically populated with the account email address.
end	N/A	End date and time of the survey.
end group	Group, Page	End a group of questions.
end repeat	Repeat	End a set of repeating questions.
file^8	File upload	Upload a file to the device.
geopoint^3	Map^3 ^6	Collect a given GPS coordinate. The default is the current location.
geoshape^3		Collect a polygon on a map.
geotrace^3		Collect a line on a map.
hidden	N/A	Create a field in your feature layer that is not displayed on the form. Use the bind::esri:fieldType and bind::esri:fieldLength columns to specify the data schema for this field.
integer^1	Number^1 ^6	Whole number input.
image	Image, Signature	Use an image from the device's files or take a photo using the camera.
note	Note	Display text on the screen. The note question type can also handle hidden calculations.
range	Slider^6	Input for a given range of numbers.
rank list_name^8	Ranking^6	A ranking question orders a list of choices. Replace list_name with the name of your choice list.
select_one list_name	Dropdown^5 ^6, Likert scale^5 ^6, Rating^6, Single select^6, Single select grid^6	Multiple choice question; only one answer can be selected. Replace list_name with the name of your choice list.
select_one_from_file file_name.csv	N/A	Multiple choice question; only one answer can be selected. Replace file_name.csv with the name of the file located in the survey's media folder that contains the list of choices.
select_multiple list_name	Dropdown^5 ^6, Multiple select^6	Multiple choice question; multiple answers can be selected. Replace list_name with the name of your choice list.
select_multiple_from_file file_name.csv	N/A	Multiple choice question; multiple answers can be selected. Replace file_name.csv with the name of the file located in the survey's media folder that contains the list of choices.
start	N/A	Start date and time of the survey.
text	Address^6, Email^6, Multiline text^5 ^6, Singleline text^6, Website^6	Free text response. A regular expression is applied to Email and Website. The geocode appearance is applied to Address.
time	Time^6	Time input.
username	N/A	When signed in with an organizational account, this question is automatically populated with the account username.

¹—The web designer combines integer and decimal questions into a single question type named Number. A check box in the properties of the question allows the survey designer to define which input is required.

²—The email question types provided in Survey123 Studio and Survey123 Connect and the web designer are implemented differently. The implementation in Survey123 Studio and Survey123 Connect automatically populates with the email address of the organizational account the user is signed in to. The implementation in the web designer is a text field that only accepts formatting matching an email address.

³—Geopoint, geotrace, and geoshape questions have been combined into a single question type named Map. A check box in the properties of the question allows the survey designer to define which input is required. An additional question type named Address allows for submitting geocoded points.

⁴—Audio questions don't allow upload in Survey123 Mobile and the field app as they do in the web app. To allow upload of audio in the field app, use a File question.

⁵—Several appearances available in Survey123 Studio and Survey123 Connect are instead available as separate question types in the web designer. These include Multiline text, Dropdown, and Likert scale.

⁶—For each question, the web designer provides an option to cache the answer. In the web app, after submitting a survey record, the answer to the question will be cached in the browser and preloaded into the next submission made for this survey on that device. Caching an answer can be set for all question types except Audio, Image, File upload, Signature, Barcode, Note, Page, Group, and Repeat.

⁷—This question type is not supported in the web app.

⁸—This question type is not supported in Survey123 Studio and Survey123 Mobile.