Frequently asked question

What are the changes to Survey123 Web Form's Query Parameters?

Last Published: April 27, 2022


What is changing?
Survey123 version 3.4 introduced the ability in the Survey123 web app (also known as the web form) to update and view existing GIS features using the mode URL query parameter. Essentially, this query parameter allows you to pass the Object ID of an existing GIS feature to preload data into a web form to view or update its contents. More details about use cases and syntax can be found at the following links:

At version 3.9, the mode query parameter underwent changes, replacing the use of objectId with globalId as the means to set the GIS feature record to be updated or viewed. For example:

This URL uses the objectId to set the feature that will be updated from the Survey123 web app. Support for the objectId parameter ends with surveys published with 3.9 or newer.

This URL uses the globalId to set the feature that will be updated from the Survey123 web app. Supported with version 3.9 and newer.

Why are we making this change?
The use of globalId to set the GIS feature to be updated is less susceptible to manipulation by end users.

How will this change affect me?
This change can potentially break existing workflows where static or dynamic links are used to update/view existing features using a web form. For example:

  • If you have embedded a web form within a dashboard to edit the selected record from a list element, this change in Survey123 query parameters can break your existing Survey123-Dashboard integration.
  • If you have a custom web map pop-up with a link to a survey web form in edit mode, this change may break your workflow.
  • If you have shared static HTML links in websites, e-mails or by other means, the links may stop loading the data to be updated.

Any survey published prior to 3.9 will continue to work normally and without modification to the query parameter, unless version locking  is disabled or the survey is republished with 3.9 or a newer version.

What should I do about this?
Before upgrading to version 3.9, we recommend that you prepare for this change:

  1. Start now documenting the web applications or workflows where you make use of the mode=edit or mode=view URL parameters.
  2. At the time of 3.9 release, existing surveys and links should continue to work without change, unless you have disabled version locking in your survey.  You should plan to adjust your URLs to be using globalId or otherwise things will break as soon you re-publish your surveys.

To make the change, you must change the URLs to use globalId instead of objectId, and also republish your surveys from either Survey123 Connect 3.9 or Survey123 web designer.

Article ID:000022837

  • ArcGIS Survey123 Website

Receive notifications and find solutions for new or common issues

Get summarized answers and video solutions from our new AI chatbot.

Download the Esri Support App

Discover more on this topic

Get help from ArcGIS experts

Contact technical support

Download the Esri Support App

Go to download options