Skip To Content

Quick reference

Survey123 for ArcGIS supports a large amount of the XLSForm specification. This reference guide provides a summary of the XLSForm features that you can use in Survey123. Surveys can be created in either Survey123 Connect or the Survey123 website; some features are currently only available in one or the other, some are available in both.

Data validation

Checking This is a required question on the Edit tab causes the survey question to require that the question contain a value before the form can be completed.

Most questions also have functionality to set a minimum and maximum length. This prevents the survey from being submitted unless the response to the question is within the defined limits. This function has the same role as either the constraint or bind::esri:fieldLength column in the Survey123 XLSForm specification.

Default values

Most question types allow you to define a default answer that is automatically used when the survey is loaded. This has the same purpose as the default column in XLSForm.

Singleline text

Singleline text provides the user with a single text box. If the text exceeds the size of the text box, it remains the same size and scrolls horizontally without line breaks. This is ideal for short answers.

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

Multiline text

Multiline text provides the user with a single, simple text box. It has no text limit, wrapping to a new line and potentially introducing a scroll bar if the text is long enough. This is ideal for long-form answers.

This behaves in the same way as a text question with a multiline appearance in Survey123 Connect.

Single choice

Single choice provides a list of potential answers from which the user selects only one; you can set one as the default on the Edit tab. There is also a check box to add an other choice, which will open an additional text box if chosen. In the Appearance section, you can choose if you want your answers to be laid out vertically or horizontally.

Single choice questions have a Set Rule button in the design section on the left. Click this to open a window that allows you to set a visibility rule for any question that comes after it. This function has the same purpose as the relevant column in XLSForm.

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

Multiple choice

Multiple choice provides a list of potential answers from which the user can select any number; you can set some as default on the Edit tab. There is also a check box to add an other choice, which will open an additional text box if chosen. In the Appearance section, you can choose if you want your answers to be laid out vertically or horizontally.

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

Dropdown

Dropdown provides a list of potential answers from which the user selects only one; you can set one as the default on the Edit tab. There is also a check box to add an other choice, which will open an additional text box if chosen. This functions identically to the single choice question but presents its answers in a drop-down list. This is ideal for a longer list of choices, as the list isn't visible unless one is being chosen.

As with single choice questions, dropdown questions have a Set Rule button in the design section on the left. Click this to open a window that allows you to set a visibility rule for any question that comes after it. This function has the same purpose as the relevant column in XLSForm.

This question type behaves in the same way as a select_one question with a minimal appearance in Survey123 Connect.

Number

Number provides a question that allows the user to use numerical values only. By default, it also permits a single decimal point. In the Validation section, you can use a check box to state whether the value must be an integer. Checking this box will remove the ability to enter a decimal point.

In place of the minimum and maximum character count, number questions have minimum and maximum values, which prevent the user from submitting their survey unless their answer is within the given range. This behaves in the same way as the constraint column in XLSForm.

This question type behaves in the same way as either an integer or a decimal question in Survey123 Connect, depending on whether you've defined the value as an integer.

Date

Date provides a calendar to select a date. As a default value, you can allow it to start on either a specified date or the date of submission for the survey. In the Validation section, you can define a date range from which the user must select.

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

Time

Time provides a question to select a time in a format of hour:minute:second in 24-hour time. A drop-down menu allows the user to select times at half-hour intervals; the selected time is presented in a text question, allowing for a more specific time. As a default value, you can allow it to start at either a specified time or the time the survey was loaded (not submitted).

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

Geopoint

Geopoint provides a map for the user to select a location that will display on a map in ArcGIS Online. By default, the location is the location of the user's device; this cannot be changed. The Default Map drop-down list allows you to select which online basemap the user will see for this question.

This question type uses a different method of displaying maps but otherwise behaves in the same way as a geopoint question in Survey123 Connect.