Microsoft Edge WebView2 (developer preview)

The Microsoft Edge WebView2 control enables you to host web content in your application using Microsoft Edge (Chromium) as the rendering engine.

The WebView2 control is currently in developer preview, during which you can prototype your solutions and share feedback with us to shape the future stable API. There will likely be some breaking changes as we evolve the API during preview, and when this happens, you will need to have both the WebView2 SDK and the Microsoft Edge (Chromium) browser updated. Breaking changes will be noted in the release notes of the SDK. This will lock down as WebView2 approaches beta and stable.

Supported Platforms

Developer preview is first available for Win32 C++ on Windows 10. In the future, we plan to have WebView2 on all the supported versions of Windows supporting C++, .NET and XAML.

Getting Started

To build and test your application using the WebView2 control, you need to have both Microsoft Edge (Chromium) and the WebView2 SDK installed. See Getting Started for detailed instructions, API reference to learn about the API, and release notes for changes made between releases.

Feedback

Help us build a richer WebView2 experience by sharing your feedback! Visit our feedback repo to submit feature requests or bug reports. It’s also a good place to search for known issues. During developer preview, we will also be collecting telemetry data to help us build a better WebView. Users can turn off WebView data collection by navigating to edge://settings/privacy in the browser and turning off browser data collection.

Evergreen vs. Bring-you-own

The WebView2 control relies on the Microsoft Edge (Chromium) browser and currently has an evergreen distribution model – instead of packaging a browser in the app bundle, apps use the evergreen browser installed on users’ machines. The evergreen browser updates itself on a regular cadence, therefore apps targeting the evergreen WebView2 automatically get the latest feature and security updates for hosted web content. The WebView2 SDK is updated separately as new APIs become available. This is the recommended model for most developers. In the future, there will be a second bring-your-own (BYO) option that allows developers to bundle a redistributable version of the browser with their apps. BYO brings a locked platform, but requires a larger disk footprint for the packaged browser and developers will have to take on the responsibility of servicing and updating the control themselves.

Browser Channels

Developers can target different channels of the Microsoft Edge (Chromium) browser to power the WebView2 control. In most cases, production applications should target the Stable channel, but developers often need to test on Beta, Dev, or Canary to ensure their applications continue to work in the near future. The WebView2 API allows developers to programmatically target either the most stable or the least stable channel installed on users’ machine. Alternatively, developers can also use the below registry key to enforce a channel. See more details in CreateWebView2EnvironmentWithDetails function.

Debugging WebView2

You can use Microsoft Edge (Chromium) Developer Tools to debug web content displayed in WebView, just as you would in the browser. While having focus on the WebView window, press F12, or press Ctrl + Shift + I, or Right Click + choose Inspect to open Developer Tools.

F12

Note when debugging application in Visual Studio with the native debugger attached, F12 may trigger the native debugger instead of Developer Tools. Use Ctrl + Shift + I, or Right Click + Inspect to avoid potential hotkey conflict.