Edit

Share via

Release Notes for the WebView2 SDK

These Release Notes provide information about new features and bug fixes that are included in the WebView2 Release SDK and the WebView2 Prerelease SDK.

1.0.3296.44

Release Date: June 03, 2025

NuGet package for WebView2 SDK 1.0.3296.44

For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 137.0.3296.44 or higher.

Promotions

The following APIs have been promoted to Stable and are now included in this Release SDK.

Set default background color on WebView2 initialization (DefaultBackgroundColor API)

The DefaultBackgroundColor API allows users to set the DefaultBackgroundColor property at initialization. This prevents a disruptive white flash during the WebView2 loading process.

Bug fixes

Runtime-only
  • Fixed the margins in the printed PDF.

1.0.3344-prerelease

Release Date: June 03, 2025

NuGet package for WebView2 SDK 1.0.3344-prerelease

For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 138.0.3344.0 or higher.

Experimental APIs

No Experimental APIs have been added in this Prerelease SDK.

Promotions

The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.

Allow input event messages to pass through the browser window

The CoreWebView2ControllerOptions class now has an AllowHostInputProcessing property, which allows user input event messages (keyboard, mouse, touch, or pen) to pass through the browser window, to be received by an app process window.

Bug fixes

Runtime-only
  • Fixed a bug where a mouse event doesn't fire after a touch event.
  • Disabled Web capture on the WebView2 control.
  • Fixed the Downloads dialog.
  • Fixed an issue with downloads in the default browser frame. (Issue #5196)
  • Fixed the margins in the printed PDF.

1.0.3240.44

Release Date: May 05, 2025

NuGet package for WebView2 SDK 1.0.3240.44

For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 136.0.3240.44 or higher.

Promotions

The following APIs have been promoted to Stable and are now included in this Release SDK.

Track navigation history for nested iframes (FrameCreatedEvent API)

The FrameCreatedEvent API supports nested iframes, such as recording the navigation history for a second-level iframe. Without this API, WebView2 only tracks first-level iframes, which are the direct child iframes of the main frame. Using this API, your app can subscribe to the nested iframe creation event, giving the app access to all properties, methods, and events of CoreWebView2Frame for the nested iframe.

Use this API to manage iframe tracking on a page that contains multiple levels of iframes. You can choose to track any of the following:

  • Only the main page and first-level iframes (the default behavior).
  • A partial WebView2 frames tree with specific iframes of interest.
  • The full WebView2 frames tree.

Bug fixes

Runtime-only
  • Fixed an issue where downloads from within the default browser frame didn't complete. (Issue #5196)
  • Fixed an issue where the pipe name was incorrectly returned, leading to a crash in some UWP apps.

1.0.3296-prerelease

Release Date: May 12, 2025

NuGet package for WebView2 SDK 1.0.3296-prerelease

For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 137.0.3296.0 or higher.

Experimental APIs

No Experimental APIs have been added in this Prerelease SDK.

Promotions

The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.

Set default background color on WebView2 initialization (DefaultBackgroundColor API)

The DefaultBackgroundColor API allows users to set the DefaultBackgroundColor property at initialization. This prevents a disruptive white flash during the WebView2 loading process.

Bug fixes

Runtime-only
  • Fixed the Find bar no longer appearing after the window is shifted.
  • Fixed a bug where the app wasn't able to cancel navigation to login pages via the NavigationStarting event.
  • Fixed an issue where downloads from within the default browser frame didn't complete. (Issue #5196)
  • Fixed an issue where the pipe name was incorrectly returned, leading to a crash in some UWP apps.

1.0.3179.45

Release Date: April 07, 2025

NuGet package for WebView2 SDK 1.0.3179.45

For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 135.0.3179.45 or higher.

Promotions

No additional APIs have been promoted to Stable and added in this Release SDK.

Bug fixes

Runtime-only
  • Fixed the HTML Select element (<select>) to make it selectable, in WPF apps.
  • Fixed navigation of edge://crashes within a WebView2 control.
  • Fixed potential crash and UI issues when invoking the Windows Credentials UI from a WebView2 instance.
  • Fixed a bug where users were unable to type in an input field with autofill info. (Issue #5144)

1.0.3230-prerelease

Release Date: April 07, 2025

NuGet package for WebView2 SDK 1.0.3230-prerelease

For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 136.0.3230.0 or higher.

Experimental APIs

No Experimental APIs have been added in this Prerelease SDK.

Promotions

The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.

Track navigation history for nested iframes (FrameCreatedEvent API)

The FrameCreatedEvent API supports nested iframes, such as recording the navigation history for a second-level iframe. Without this API, WebView2 only tracks first-level iframes, which are the direct child iframes of the main frame. Using this API, your app can subscribe to the nested iframe creation event, giving the app access to all properties, methods, and events of CoreWebView2Frame for the nested iframe.

Use this API to manage iframe tracking on a page that contains multiple levels of iframes. You can choose to track any of the following:

  • Only the main page and first-level iframes (the default behavior).
  • A partial WebView2 frames tree with specific iframes of interest.
  • The full WebView2 frames tree.

Bug fixes

Runtime-only
  • Fixed an issue in WPF where the <datalist> dropdown closed when the mouse moved outside the WebView2 control bounds.
  • Fixed navigation of edge://crashes within a WebView2 control.
  • Fixed the HTML Select element (<select>) to make it selectable, in WPF apps.
  • Fixed potential crash and UI issues when invoking the Windows Credentials UI from a WebView2 instance.
  • Fixed bug where users unable to type in input field with autofill info. (Issue #5144)
  • Fixed a regression in the Status bar APIs.
SDK-only
  • Fixed Tab, Shift+Tab, and Arrow keys in Window to Visual hosting mode.

1.0.3124.44

Release Date: March 10, 2025

NuGet package for WebView2 SDK 1.0.3124.44

For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 134.0.3124.44 or higher.

Promotions

No additional APIs have been promoted to Stable and added in this Release SDK.

Bug fixes

Runtime-only
  • Extensions won't get disabled in WebView2 by using AddBrowserExtensionAsync, regardless of whether developer mode is on. (Issue #5113)
  • Disabled background update of network time. (Issue #5047)
  • Fixed the download popup not being displayed when target="_blank". (Issue #5063)

1.0.3171-prerelease

Release Date: March 10, 2025

NuGet package for WebView2 SDK 1.0.3171-prerelease

For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 135.0.3171.0 or higher.

Experimental APIs

No Experimental APIs have been added in this Prerelease SDK.

Promotions

No APIs have been promoted from Experimental to Stable in this Prerelease SDK.

Bug fixes

Runtime and SDK
  • Fixed host object async method exception handling. (Issue #3402)
  • Fixed documentation for CoreWebVIew2.Navigate. (Issue #5091)
Runtime-only
  • Fixed an "Add to Chrome" store installation regression.
  • Fixed folder uploads in UWP and WinUI. (Issue #3275)
  • Extensions won't get disabled in WebView2 by using AddBrowserExtensionAsync, regardless of whether developer mode is on. (Issue #5113)
  • Disabled background update of network time. (Issue #5047)
  • Fixed the download popup not being displayed when target="_blank". (Issue #5063)
SDK-only
  • Fixes a crash that could occur when the Garbage Collector calls Finalize on a thread other than the main thread.

1.0.3065.39

Release Date: February 10, 2025

NuGet package for WebView2 SDK 1.0.3065.39

For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 133.0.3065.39 or higher.

Promotions

No additional APIs have been promoted to Stable and added in this Release SDK.

Bug fixes

Runtime-only
  • Added the missing Close button in the Download flyout.
  • Fixed a race condition that occurred when the Web Request Response event never occurs.

1.0.3116-prerelease

Release Date: February 10, 2025

NuGet package for WebView2 SDK 1.0.3116-prerelease

For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 134.0.3116.0 or higher.

Experimental APIs

No Experimental APIs have been added in this Prerelease SDK.

Promotions

No APIs have been promoted from Experimental to Stable in this Prerelease SDK.

Bug fixes

Runtime-only
  • Added the missing Close button in the Download flyout.
  • Fixed a race condition that occurred when the Web Request Response event never occurs.
SDK-only
  • Fixed .NET and Win32 documentation of the CoreWebView2Find.FindNext method that incorrectly mentioned FindPrevious. The method summary now mentions FindNext instead. (Issue #5059)

See also