PROBLEM

ArcGIS Survey123 field app (Windows) fails to launch via URL scheme

Last Published: April 27, 2022

Description

The ArcGIS Survey123 field app fails to open when invoked via URL, for example, ArcGIS-survey123://, despite it being installed and opened directly without any problem.

Navigating to the Survey123 for ArcGIS URL returns the message, "Do you want to allow this website to open an app on your computer?"
Clicking Allow prompts the message, "You'll need a new app to open this ArcGIS-survey123."

Image of Internet Explorer prompt to allow website to run app
Image of Windows prompt to find new app
 

Cause

The Windows registry keys that link the URI scheme to the application are not present on the machine. These registry keys are created with the installation of ArcGIS Survey123. The registry update is likely blocked by a Windows security setting, anti-virus, or other security monitoring software.

Note:
For more information on how URI schemes are registered, view Microsoft's documentation on registering an application to a URI scheme.

Solution or Workaround

Reinstall ArcGIS Survey123 with admin privileges

Note:
In may be necessary to contact a system administrator to perform the following steps.
  1. Identify the policy or application blocking ArcGIS Survey123 from updating the registry at the time of installation. If unsure, refer to the system administrator for assistance.
  2. Disable/circumvent the policy.
  3. Reinstall ArcGIS Survey123.

If this does not resolve the issue, perform the next set of instructions:

Create the registry keys manually via Registry Editor

Warning:   
The instructions below include making changes to essential parts of your operating system. It is recommended that you backup your operating system and files, including the registry, before proceeding. Consult a qualified computer systems professional, if necessary.

Esri cannot guarantee results from incorrect modifications while following these instructions. Therefore, use caution and proceed at your own risk.
  1. Launch Notepad.
  2. Enter the following text:
Windows Registry Editor Version 5.00

[HKEY_CURRENT_USER\Software\Classes\arcgis-survey123]
@="URL:arcgis-survey123"
"URL Protocol"=""

[HKEY_CURRENT_USER\Software\Classes\arcgis-survey123\shell]
@="open"

[HKEY_CURRENT_USER\Software\Classes\arcgis-survey123\shell\open]
@=""

[HKEY_CURRENT_USER\Software\Classes\arcgis-survey123\shell\open\command]
@="\"C:\\Users\\<USER>\\Applications\\ArcGIS\\ArcGISSurvey123\\ArcGISSurvey123.exe\" \"%1\""
Note:
The above registry key applies to ArcGIS Survey123 version 3.10, and may not apply to other versions.
Please note that prior to ArcGIS Survey123 3.10 the path to the executable file on the last line should be:
 @="\"C:\\Users\\<USER>\\Applications\\ArcGIS\\Survey123forArcGIS\\Survey123forArcGIS.exe\" \"%1\""
Note:
The 'command' key must be updated with the path to the installation directory for the given user. The user path must be specified as an absolute path and cannot use an environment variable (for example, %USERPROFILE%).
  1. Save the file as a .reg file.
  2. Execute the .reg file to import the keys to the registry. Click Yes when prompted by Windows.

Article ID:000020276

Software:
  • ArcGIS Survey123 Website

Get help from ArcGIS experts

Contact technical support

Download the Esri Support App

Go to download options

Related Information

Discover more on this topic