English

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

Description

The Survey123 for ArcGIS field app fails to open when invoked via URL (i.e. 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 Survey123 for ArcGIS. 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 Survey123 for ArcGIS with admin privileges

Note:
Users may have to approach their system administrator to perform the following steps.
  1. Identify the policy or application blocking Survey123 for ArcGIS 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 Survey123 for ArcGIS.

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


Create the registry keys manually via Registry Editor

Warning:   
Editing the Windows registry is dangerous and must only be done as a last resort. Backup the registry and/or machine prior to performing the steps listed below.
Consult a qualified computer systems professional, if necessary.
Esri cannot guarantee results from incorrect modifications following these instructions. Users are advised to exercise caution and proceed at their 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\\Survey123forArcGIS\\Survey123forArcGIS.exe\" \"%1\""
Note:
This registry key applies to Survey123 for ArcGIS version 3.2 and may not apply to other versions.
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.

Related Information