Edit

Release notes for WebView2 SDKs

Release notes for recent SDKs:

For earlier release notes, see Archive in the table of contents.

You can view the list of Microsoft.Web.WebView2 SDK packages at the NuGet site.

Generally, release notes apply across the supported platforms, which are listed in WebView2 API Reference. For an outline of APIs that are in Release SDK packages, see Overview of WebView2 APIs.

Release notes entries correspond to historical releases of WebView2, and are not updated over time. References to "new features" and "experimental APIs" might become outdated as new versions of WebView2 are released.

Release cadence

WebView2 SDKs and WebView2 Prerelease SDKs are released when there are bug fixes, security fixes, new APIs or features, or other SDK changes that warrant a release.

When a WebView2 SDK is published, it aligns with the corresponding WebView2 Runtime version.

Phases of adding APIs

New APIs are added in three phases, as follows:

  1. APIs are initially introduced as Experimental APIs in a Prerelease SDK package. In Win32, the type name includes the word "Experimental".

    • Sometimes, APIs skip the Experimental phase and are added directly into a Stable in Prerelease SDK.

  2. Then the APIs become Stable APIs in a Prerelease SDK package. In Win32, the type name omits the word "Experimental".

  3. Soon after, the APIs become Stable APIs in a Release SDK package.

    • Sometimes, APIs are simultaneously promoted to Stable in a Prerelease SDK and Stable in a Release SDK.

Diagram of phases of introducing new APIs

Shorthand names of the phases:

  1. Experimental in Prerelease
  2. Stable in Prerelease
  3. Stable in Release

Release notes sections use this wording for the phases:

  • The following APIs are in Phase 1: Experimental in Prerelease, and have been added in this Prerelease SDK.

  • The following APIs have been promoted from Phase 1: Experimental in Prerelease, to Phase 2: Stable in Prerelease, and are included in this Prerelease SDK.

  • The following APIs have been promoted from Phase 2: Stable in Prerelease, to Phase 3: Stable in Release, and are now included in this Release SDK.

See also:

Updating the SDK

WebView2 changes may require an update to the Runtime, SDK, or both. Most new APIs require both Runtime and SDK updates.

To install or update the WebView2 SDK, see Install or update the WebView2 SDK in Set up your Dev environment for WebView2.

See also:

Make sure to re-compile your WebView2 app after updating the WebView2 SDK NuGet package. The WebView2 team recommends the following:

  • Use the Canary preview channel of Microsoft Edge when you develop using a Prerelease version of the WebView2 SDK package. Canary is the recommended preview channel, because it ships at the fastest cadence and has the newest APIs.

  • Use the Evergreen WebView2 Runtime when you use a release version of the WebView2 SDK package.

For more information, see Matching the Runtime version with the SDK version in Prerelease and Release SDKs for WebView2.

Minimum version of the browser or Runtime to load WebView2

To load WebView2, the minimum version of Microsoft Edge or the WebView2 Runtime is 86.0.616.0. The minimum version to load WebView2 only changes when a breaking change occurs in the web platform.

To use a Prerelease SDK along with a Microsoft Edge preview channel, see Test upcoming APIs and features.

See also

API Reference:

  • Last updated on