Configure the ArcGIS Pro Chromium WebView2 control to use the WebView2 Evergreen Runtime

Summary

Note:
Beginning at version 3.3, ArcGIS Pro has switched entirely to leveraging the Microsoft Edge WebView2 Runtime and will no longer install a Fixed Version during the application setup process, making this workflow valid for ArcGIS Pro version 2.9 through 3.2 only.
If the Microsoft Edge WebView2 Runtime is not already installed on your machine, it can be downloaded using the Evergreen Bootstrapper or Evergreen Standalone Installer from Microsoft.

About WebView2
Starting at version 2.9, ArcGIS Pro uses the Microsoft Edge WebView2 to present HTML and JavaScript content in the application user interface. The WebView2 control uses Microsoft Edge (Chromium) as the engine for processing and rendering this content.

WebView2 Runtime Distributions
Microsoft Edge WebView2 is supported by a runtime installed on the computer. The runtime includes the Chromium browser code that WebView2 uses for processing HTML and JavaScript content. There are two distributions of the WebView2 runtime: Fixed Version and Evergreen. ArcGIS Pro uses Fixed Version by default, but can be configured to use Evergreen instead.

• Fixed Version Runtime (default) ArcGIS Pro includes the WebView2 Fixed Version runtime as part of every ArcGIS Pro installation, and uses it by default. It is installed to the WebView folder inside of \ArcGIS\Pro\bin. This version of the runtime is updated whenever you install a new version of ArcGIS Pro, including any ArcGIS Pro patch release that includes a WebView2 update.
• Evergreen Runtime (optional) Microsoft provides an alternative distribution called the WebView2 Evergreen Runtime. This is software that you install on your computer separately from ArcGIS Pro. Because it is installed separately, you can update it to newer versions without waiting for an update of ArcGIS Pro. You can download the WebView2 Evergreen Runtime from the Microsoft Edge WebView2 home page. If prompted to select an architecture to download, select the 'x64' option.

Procedure

Configure ArcGIS Pro to use WebView2 Evergreen mode

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.

Note:
The following procedure modifies the HKEY_LOCAL_MACHINE portion of the Windows registry, and requires Administrator permission to complete.

1. Confirm that the Evergreen Runtime has been installed on the computer. You should see an entry for it in the Programs and Features section of the Control Panel called Microsoft Edge WebView2 Runtime.
2. Close all open instances of ArcGIS Pro.
3. Open the Windows Registry Editor (regedit.exe) and browse to the following folder:

HKEY_ LOCAL_MACHINE\Software\ESRI\ArcGISPro\Settings

• • This folder may not exist if the computer has never had ArcGIS Pro installed.

4. Create a new DWORD (32-bit) value, and name it WebViewEvergreenMode.
5. Edit the newly created registry value, changing the value data from 0 to 1.
6. Close regedit.exe and start ArcGIS Pro. It uses the installed version of the Evergreen Runtime instead of the Fixed Version that was installed with ArcGIS Pro.

To switch back to the Fixed Version runtime, either change WebViewEvergreenMode from 1 to 0 in the Registry Editor, or delete the WebViewEvergreenMode value entirely.