Select to view content in your preferred language

What's new in ArcGIS Survey123 (February 2022)

02-24-2022 07:23 PM
Esri Notable Contributor
9 11 4,384



The ArcGIS Survey123 February 2022 update is now available. This release includes great additions to the Survey123 web designer to help you visually create more powerful smart forms. The Survey123 field app includes massive improvements to make calculations faster and support for custom markup tools. All of that, and much more!

Read on to learn what’s new:

Survey123 web designer and web app

  • Use your own web maps in a survey
  • Have your survey automatically get the respondent’s location
  • Use your own locators with the address and map questions

Survey123 Connect and field app:

  • Faster calculations and new calculation modes
  • Markup photos, maps and diagrams with custom markup tool palettes
  • New Media tab and Overview folder option

Other enhancements and important release notes:

  • Expanded report syntax
  • Other release notes



Survey123 web designer and web app


The Survey123 web designer helps you visually create smart forms, right from a web browser. In recent updates we added support for the new Address question type, introduced calculations, and added options to permanently hide questions in your form.

This release brings more enhancements to the Map and Address question types.


Use your own web maps in a survey


Up until this release, you could configure a default map for your survey. Well, kind of, as you could only choose a map already present in  your organization’s basemap gallery. Now, however, you can select any web map!

Note that a new Edit option has been added to help you configure the contents of your map. You can select a map you own as well as other maps from your organization.

001_Survey123 Designer Change Map.gif


Have your survey automatically get the respondent’s location


Map questions now support various options to determine the default location. Use these options to specify the behavior of your map: Should the map automatically center when the survey is opened? Or when the user interacts with the map? What if instead the map should be centered at a predetermined location?

002 Designer New Default Map Location Options.jpg

Automatically centering the map when the form loads is something new for online surveys. Combined with calculations, it is a powerful option because it makes your smart forms location-aware.

Say, for example, you create a survey to report issues in your city. Since you know where the user is, you can automatically populate questions such as city, postal code or address where the incident happens.


Use your own locators with the address and map questions


Many people may not know how to pinpoint the location of something in a map, but for sure they will now its address. We introduced the address question type in our previous release. It helps respondents complete an address as they type.

To simplify data entry boost the quality of your data, it is good practice to configure address questions with your own locators. You can now easily do that right from the Survey123 designer.

003_Survey123 Designer Change Locator.gif


If you are creating a web survey to collect information in your city, why would you use a locator with addresses from other places? Learn how to create your own locator, share it, and use it with your Survey123 address questions.

Survey123 Connect and field app


Survey123 Connect is a desktop tool. With it, you can author the most sophisticated forms using an XLSForm spreadsheet. The Survey123 field app is available for iOS, Android and Windows devices.  It includes advanced options to work with your smart forms from the field, or the office.

The new build numbers for Survey123 Connect and the field app are 3.14.256 and 3.14.237, respectively.

Faster calculations and new calculation modes


Calculations in a smart form allow you to populate questions based on previously entered responses. The calculation execution in the Survey123 field app has been optimized to make your forms faster. You will appreciate the difference when working with very large forms.

Additionally, starting with this release, you can specify three different calculation modes in your questions:

  • Auto: The calculation is triggered if the question is empty or if it has not been previously modified by the user. This is the default mode and the only one available up until this release.
  • Always: Auto-calculates the value, even if the user has already entered a value.
  • Manual: Use this option if you want the user to trigger the calculation manually.

The new calculation modes give you more flexibility to dictate the logic of your form.


Markup photos, maps and diagrams with custom markup tool palettes


Survey123 includes image annotation tools. With them, users can markup photos, diagrams and maps. We gave these tools an overhaul in late 2021. This update introduces the concept of custom annotation tool palettes.

004 Survey123 markup tools.gif


While Survey123 comes with its own annotation tools, you may want to tailor the user experience, so it best fits your workflows. For example, if you are supporting an effort where you know users will markup in a photo the location of existing water and gas meters, you will want to create markup tools for these two features, and nothing else.

Below are some examples of custom annotation tool palettes. Note that each of the tools has its own meaning. They are all categorized logically into separate groups.

004 Survey123 Custom Annotation tools.png

Custom annotation tools make image markup more intuitive, but they also help generate more consistent image annotations.

Find more about custom annotation tools,  in our documentation and this blog post.



New media tab and overview folder option


Use the new Media tab in Survey123 Connect to quickly visualize the contents of the media folder for your survey, such as CSV files, custom annotation palettes, audio files and images.


On the Options tab, you will find a new switcher to enable or disable the Overview folder. The Overview folder is useful when you want users of the Survey123 field app to view all survey records in a single map or list.

Other enhancements and important notes


Improved report syntax


Use new report syntax to display multiple records on a single map. You can also rotate photos!


Other release notes


As announced in May 2021, macOS installers for Survey123 Connect and Survey123 field app are no longer available with version 3.14.

Access to the Survey123 field app and Connect source code in ArcGIS AppStudio is now available only upon request. Complete this form if you would like access. 3.14 will be the last version of the source code available.

Image questions (with or without the draw or annotate appearance) will not allow you to browse for existing images in your device, unless you enable local image browsing. This can be done right from within Survey123 web designer as well as from Connect using method=browse in the body::esri:style column. More details in the Survey123 Tricks of the Trade: Photos blog.

The next updates are planned for March 2022 and April 2022. If you want to get up to speed on new features coming, join the Survey123 Early Adopter Community.




BUG-000144684 ArcGIS Survey123 field app shows duplicate choices for a select_one question with choices which contains integers only if the survey has another select_one question with more than 256 choices when the survey is updated on the device after republishing the survey
BUG-000144253 The headings for a table-list appearance are not visible when repeats are applied on the groups in the ArcGIS Survey123 field app
BUG-000143625 The select_one question type in ArcGIS Survey123 Connect or field app 3.13 populates the field domain (name) after selecting the field label (label) when the field domain is 10 or more digits
BUG-000119569 In the Survey123 for ArcGIS Mobile App, SAML ADFS logins are cached, preventing a new user from signing in when a previous user signs out
BUG-000143746 When using a geopoint question, ArcGIS Survey123 crashes on Android devices when an organization is configured with a custom geocoder

Issues causing application crash with complex surveys: BUG-000138740, BUG-000125886 ,BUG-000133842, BUG-000133237,BUG-000128201, BUG-000126685, BUG-000125015, BUG-000108085, BUG-000111086

BUG-000144753 Blank survey responses submitted for nested repeats prevent reports from being generated in the ArcGIS Survey123 website when surveys are published to Portal and surveys are submitted from the ArcGIS Survey123 field app
BUG-000140014 Thumbnails misalign on the ArcGIS Survey123 field app when the download list is refreshed
BUG-000129066 Image is not loading in the Survey123 field app via dynamic URL creation using placeholders
BUG-000127011 When using the Survey123 for ArcGIS field app, an image attachment disappears when the survey is edited from Outbox having a 'repeat' set with image question

BUG-000128495 Substr() functions do not update to show the most recent selection when editing existing survey submissions from the Inbox which initially do not contain a response in the substr() dependent field
BUG-000101479 Unpublished online surveys do not open in Survey123 Connect for ArcGIS

BUG-000145342 Unable to generate a report in ArcGIS Survey123 if there are too many getValue expressions of an attachment in the if conditional statement.
BUG-000145620 Querying a hosted feature layer created from ArcGIS Survey123 Connect returns a respectsDaylightSaving error message
BUG-000145304 ArcGIS Survey123 does not capture the updated responses passed through the custom URL parameters when editing existing submissions
BUG-000142188 When loading dates (MM/DD/YYYY) from the data taken from ArcGIS Survey123 website and ArcGIS Survey123 Connect labels sometimes work incorrectly, either failing to list Months (MM) or Years (YYYY) appropriately
BUG-000143583 If there is no attachment outside the repeat or no other questions answered inside the repeat, the ArcGIS Survey123 website does not show the repeat's image attachments on the Individual Response pane for surveys hosted on versions of Portal for ArcGIS older than 10.8
BUG-000112346 The default latitude and longitude of a read-only geopoint question that captures devices location is zero when using link for a survey
BUG-000142529 The ArcGIS Survey123 mobile app display issues with the language selector
BUG-000143301 Creating the Set rule -function does not work properly in Survey123 when the Address -component is used in the survey before the Set rule -component
BUG-000135434 ArcGIS Survey123 (On premise) post-installation within IE11 shows only The survey does not exist or is not accessible