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.3537.50

Release Date: October 6, 2025

NuGet package for WebView2 SDK 1.0.3537.50

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

Promotions

No additional APIs have been promoted from Phase 2: Stable in Prerelease, to Phase 3: Stable in Release, in this Release SDK.

Bug fixes

This Release SDK includes the following bug fixes.

Runtime-only
  • Fixed local network access triggering a permission alert pop-up window.
SDK-only
  • Fixed a BinSkim error for WebView2Loader.dll.

1.0.3590-prerelease

Release Date: October 7, 2025

NuGet package for WebView2 SDK 1.0.3590-prerelease

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

Experimental APIs

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

Sensitivity label support

A new Sensitivity Info API in WebView2 enables applications to access sensitivity label information communicated by webpages through the Page Interaction Restriction Manager. This feature helps host applications detect and respond to sensitive content.

Key capabilities:

  • Configure Page Interaction Restriction Manager availability - Configure a list of URL filters for the Page Interaction Restriction Manager. After the list has been configured, the Page Interaction Restriction Manager becomes available on pages in the allow list. These pages can send sensitivity labels to the platform via the API.

  • Sensitivity Info exposure - CoreWebView2 now exposes a SensitivityInfo property and a SensitivityInfoChanged event, allowing applications to listen for updates to sensitivity label information.

Sensitivity label support is initially available on Win32 only. Support for .NET and WinRT is planned for a future release.

Promotions

No APIs have been promoted from Phase 1: Experimental in Prerelease, to Phase 2: Stable in Prerelease, in this Prerelease SDK.

Bug fixes

This Prerelease SDK includes the following bug fixes.

Runtime-only
  • Fixed a dangling pointer in file system access permission context.
  • Fixed the UI hanging during drag-and-drop in WinUI3.
  • Fixed local network access triggering a permission alert pop-up window.
  • Resolved an issue where an extra region was appearing in the accessibility tree.
  • Fixed an issue where downloads in the default browser frame didn't work.
SDK-only
  • Fixed a BinSkim error for WebView2Loader.dll.

1.0.3485.44

Release Date: September 8, 2025

NuGet package for WebView2 SDK 1.0.3485.44

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

General changes

This Release SDK focuses on making WebView2 work better, through behind-the-scenes improvements.

  • The testing infrastructure has been strengthened.
  • The validation of APIs has been enhanced, to ensure that the APIs perform reliably across different scenarios.

These foundational improvements provide stable, thoroughly tested functionality for building WebView2 apps.

Promotions

No additional APIs have been promoted from Phase 2: Stable in Prerelease, to Phase 3: Stable in Release, in this Release SDK.

Bug fixes

There are no bug fixes in this Release SDK.

1.0.3530-prerelease

Release Date: September 8, 2025

NuGet package for WebView2 SDK 1.0.3530-prerelease

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

General changes

This Prerelease SDK focuses on making WebView2 work better, through behind-the-scenes improvements.

  • The testing infrastructure has been strengthened.
  • The validation of APIs has been enhanced, to ensure that the APIs perform reliably across different scenarios.

These foundational improvements provide stable, thoroughly tested functionality for building WebView2 apps.

Experimental APIs

No Experimental APIs have been added in this Prerelease SDK.

Promotions

No APIs have been promoted from Phase 1: Experimental in Prerelease, to Phase 2: Stable in Prerelease, in this Prerelease SDK.

Bug fixes

This Prerelease SDK includes the following bug fixes.

SDK-only
  • Fixed a memory leak in WPF Composition Controller.

1.0.3405.78

Release Date: August 11, 2025

NuGet package for WebView2 SDK 1.0.3405.78

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

Promotions

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.

Customize the Find behavior (Find API)

The Find API allows you to programmatically control Find operations, and enables adding the following functionality to your app:

  • Customize Find options, including Find Term, Case Sensitivity, Word Matching, Match Highlighting, and Default UI Suppression.
  • Find text strings and navigate among them within a WebView2 control.
  • Programmatically initiate Find operations, and navigate Find results.
  • Suppress the default Find UI.
  • Track the status of Find operations.

There are known issues with the Find API for PDF documents. When you view a PDF document within a WebView2 control, the Find feature currently only provides the first index and the number of matches found. For example, if the string occurs three times in a PDF, the UI would say 1/3 and would not support programmatically calling Next or Previous.

We're actively investigating these issues, and we encourage you to report any problems you encounter, by using the WebView2Feedback repo.

Bug fixes

Runtime-only
  • Fixed a crash in Devtools on Windows Server and Windows 10.

1.0.3477-prerelease

Release Date: August 11, 2025

NuGet package for WebView2 SDK 1.0.3477-prerelease

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

Experimental APIs

No Experimental APIs have been added in this Prerelease SDK.

Promotions

No APIs have been promoted from Phase 1: Experimental in Prerelease, to Phase 2: Stable in Prerelease, in this Prerelease SDK.

Bug fixes

Runtime-only
  • Fixed put_UserAgent not working for service workers.
  • Fixed a crash in Devtools on Windows Server and Windows 10.
  • Removed browser process tracking after calling remove_BrowserProcessExited.
  • Fixed a memory leak issue in hostObject async function calls.
  • Fixed touch not working in visual hosting after a long tap.

1.0.3351.48

Release Date: July 1, 2025

NuGet package for WebView2 SDK 1.0.3351.48

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

Promotions

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.

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 blackbox issue on dialogs in visual hosting.

1.0.3415-prerelease

Release Date: July 14, 2025

NuGet package for WebView2 SDK 1.0.3415-prerelease

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

Experimental APIs

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

Enable background processing and offline support (WebView2 Worker APIs)

The WebView2 Worker APIs allow host applications to interact with Web Workers to offload tasks from the main thread, improve responsiveness, and support background operations. These Web Workers include Dedicated Workers, Shared Workers, and Service Workers.

These APIs provide:

  • Lifecycle Events: Monitor creation and destruction of workers.
  • Messaging Interfaces: Communicate with workers using PostMessage and WebMessageReceived.
  • Worker Management: Query and retrieve worker registrations and instances.
Render custom title bars (Window Controls Overlay API)

The Window Controls Overlay API enables developers to create custom title bars by rendering caption buttons (minimize, maximize, restore, close) directly inside the WebView2 window. The Window Controls Overlay appears in the top corner of the WebView, and integrates seamlessly with your app's UI.

Use this API when:

  • You want to replace the default OS title bar with a fully customized in-app title bar.
  • You're working with non-client region features, such as app-region: drag and IsNonClientRegionSupportEnabled.

This API is ideal for apps that require a modern, immersive UI experience.

Promotions

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.

Customize the Find behavior (Find API)

The Find API allows you to programmatically control Find operations, and enables adding the following functionality to your app:

  • Customize Find options, including Find Term, Case Sensitivity, Word Matching, Match Highlighting, and Default UI Suppression.
  • Find text strings and navigate among them within a WebView2 control.
  • Programmatically initiate Find operations, and navigate Find results.
  • Suppress the default Find UI.
  • Track the status of Find operations.

There are known issues with the Find API for PDF documents. When you view a PDF document within a WebView2 control, the Find feature currently only provides the first index and the number of matches found. For example, if the string occurs three times in a PDF, the UI would say 1/3 and would not support programmatically calling Next or Previous.

We're actively investigating these issues, and we encourage you to report any problems you encounter, by using the WebView2Feedback repo.

Bug fixes

Runtime-only
  • Fixed a blackbox issue on dialogs in visual hosting.
  • Fixed put_UserAgent not working for service workers.
  • Fixed crash in DevTools on Windows Server and Windows 10.

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.

See also

API Reference: