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

.NET/C#

• CoreWebView2ControllerOptions Class:
  • CoreWebView2ControllerOptions.AllowHostInputProcessing Property

WinRT/C#

• CoreWebView2ControllerOptions Class:
  • CoreWebView2ControllerOptions.AllowHostInputProcessing Property

Win32/C++

• ICoreWebView2ControllerOptions4
  • ICoreWebView2ControllerOptions4::get_AllowHostInputProcessing
  • ICoreWebView2ControllerOptions4::put_AllowHostInputProcessing

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.

.NET/C#

• CoreWebView2 Class:
  • CoreWebView2.DedicatedWorkerCreated Event

• CoreWebView2DedicatedWorker Class
  • CoreWebView2DedicatedWorker.DedicatedWorkerCreated Event
  • CoreWebView2DedicatedWorker.Destroying Event
  • CoreWebView2DedicatedWorker.PostWebMessageAsJson Method
  • CoreWebView2DedicatedWorker.PostWebMessageAsString Method
  • CoreWebView2DedicatedWorker.ScriptUri Property
  • CoreWebView2DedicatedWorker.WebMessageReceived Event

• CoreWebView2DedicatedWorkerCreatedEventArgs Class
  • CoreWebView2DedicatedWorkerCreatedEventArgs.OriginalSourceFrameInfo Property
  • CoreWebView2DedicatedWorkerCreatedEventArgs.Worker Property

• CoreWebView2Frame Class:
  • CoreWebView2Frame.DedicatedWorkerCreated Event

• CoreWebView2Profile Class:
  • CoreWebView2Profile.ServiceWorkerManager Property
  • CoreWebView2Profile.SharedWorkerManager Property

• CoreWebView2ServiceWorker Class
  • CoreWebView2ServiceWorker.Destroying Event
  • CoreWebView2ServiceWorker.PostWebMessageAsJson Method
  • CoreWebView2ServiceWorker.PostWebMessageAsString Method
  • CoreWebView2ServiceWorker.ScriptUri Property
  • CoreWebView2ServiceWorker.WebMessageReceived Event

• CoreWebView2ServiceWorkerActivatedEventArgs Class
  • CoreWebView2ServiceWorkerActivatedEventArgs.ActiveServiceWorker Property

• CoreWebView2ServiceWorkerManager Class
  • CoreWebView2ServiceWorkerManager.GetServiceWorkerRegistrationsAsync Method
  • CoreWebView2ServiceWorkerManager.GetServiceWorkerRegistrationsAsync Method
  • CoreWebView2ServiceWorkerManager.ServiceWorkerRegistered Event

• CoreWebView2ServiceWorkerRegisteredEventArgs Class
  • CoreWebView2ServiceWorkerRegisteredEventArgs.ServiceWorkerRegistration Property

• CoreWebView2ServiceWorkerRegistration Class
  • CoreWebView2ServiceWorkerRegistration.ActiveServiceWorker Property
  • CoreWebView2ServiceWorkerRegistration.Origin Property
  • CoreWebView2ServiceWorkerRegistration.ScopeUri Property
  • CoreWebView2ServiceWorkerRegistration.ServiceWorkerActivated Event
  • CoreWebView2ServiceWorkerRegistration.TopLevelOrigin Property
  • CoreWebView2ServiceWorkerRegistration.Unregistering Event

• CoreWebView2SharedWorker Class
  • CoreWebView2SharedWorker.Destroying Event
  • CoreWebView2SharedWorker.Origin Property
  • CoreWebView2SharedWorker.ScriptUri Property
  • CoreWebView2SharedWorker.TopLevelOrigin Property

• CoreWebView2SharedWorkerCreatedEventArgs Class
  • CoreWebView2SharedWorkerCreatedEventArgs.Worker Property

• CoreWebView2SharedWorkerManager Class
  • CoreWebView2SharedWorkerManager.GetSharedWorkersAsync Method
  • CoreWebView2SharedWorkerManager.SharedWorkerCreated Event

WinRT/C#

• CoreWebView2 Class:
  • CoreWebView2.DedicatedWorkerCreated Event

• CoreWebView2DedicatedWorker Class
  • CoreWebView2DedicatedWorker.DedicatedWorkerCreated Event
  • CoreWebView2DedicatedWorker.Destroying Event
  • CoreWebView2DedicatedWorker.PostWebMessageAsJson Property
  • CoreWebView2DedicatedWorker.PostWebMessageAsString Property
  • CoreWebView2DedicatedWorker.ScriptUri Property
  • CoreWebView2DedicatedWorker.WebMessageReceived Event

• CoreWebView2DedicatedWorkerCreatedEventArgs Class
  • CoreWebView2DedicatedWorkerCreatedEventArgs.Worker Property
  • CoreWebView2DedicatedWorkerCreatedEventArgs.OriginalSourceFrameInfo Property

• CoreWebView2Frame Class:
  • CoreWebView2Frame.DedicatedWorkerCreated Event

• CoreWebView2Profile Class:
  • CoreWebView2Profile.ServiceWorkerManager Property
  • CoreWebView2Profile.SharedWorkerManager Property

• CoreWebView2ServiceWorker Class
  • CoreWebView2ServiceWorker.Destroying Event
  • CoreWebView2ServiceWorker.PostWebMessageAsJson Property
  • CoreWebView2ServiceWorker.PostWebMessageAsString Property
  • CoreWebView2ServiceWorker.ScriptUri Property
  • CoreWebView2ServiceWorker.WebMessageReceived Event

• CoreWebView2ServiceWorkerActivatedEventArgs Class
  • CoreWebView2ServiceWorkerActivatedEventArgs.ActiveServiceWorker Property

• CoreWebView2ServiceWorkerManager Class
  • CoreWebView2ServiceWorkerManager.GetServiceWorkerRegistrationsAsync Property
  • CoreWebView2ServiceWorkerManager.GetServiceWorkerRegistrationsAsync Property
  • CoreWebView2ServiceWorkerManager.ServiceWorkerRegistered Event

• CoreWebView2ServiceWorkerRegisteredEventArgs Class
  • CoreWebView2ServiceWorkerRegisteredEventArgs.ServiceWorkerRegistration Property

• CoreWebView2ServiceWorkerRegistration Class
  • CoreWebView2ServiceWorkerRegistration.ActiveServiceWorker Property
  • CoreWebView2ServiceWorkerRegistration.Origin Property
  • CoreWebView2ServiceWorkerRegistration.ScopeUri Property
  • CoreWebView2ServiceWorkerRegistration.ServiceWorkerActivated Event
  • CoreWebView2ServiceWorkerRegistration.TopLevelOrigin Property
  • CoreWebView2ServiceWorkerRegistration.Unregistering Event

• CoreWebView2SharedWorker Class
  • CoreWebView2SharedWorker.Destroying Event
  • CoreWebView2SharedWorker.Origin Property
  • CoreWebView2SharedWorker.ScriptUri Property
  • CoreWebView2SharedWorker.TopLevelOrigin Property

• CoreWebView2SharedWorkerCreatedEventArgs Class
  • CoreWebView2SharedWorkerCreatedEventArgs.Worker Property

• CoreWebView2SharedWorkerManager Class
  • CoreWebView2SharedWorkerManager.GetSharedWorkersAsync Property
  • CoreWebView2SharedWorkerManager.SharedWorkerCreated Event

Win32/C++

• ICoreWebView2Experimental30
  • ICoreWebView2Experimental30::add_DedicatedWorkerCreated
  • ICoreWebView2Experimental30::remove_DedicatedWorkerCreated

• ICoreWebView2ExperimentalDedicatedWorker
  • ICoreWebView2ExperimentalDedicatedWorker::add_DedicatedWorkerCreated
  • ICoreWebView2ExperimentalDedicatedWorker::add_Destroying
  • ICoreWebView2ExperimentalDedicatedWorker::add_WebMessageReceived
  • ICoreWebView2ExperimentalDedicatedWorker::get_ScriptUri
  • ICoreWebView2ExperimentalDedicatedWorker::PostWebMessageAsJson
  • ICoreWebView2ExperimentalDedicatedWorker::PostWebMessageAsString
  • ICoreWebView2ExperimentalDedicatedWorker::remove_DedicatedWorkerCreated
  • ICoreWebView2ExperimentalDedicatedWorker::remove_Destroying
  • ICoreWebView2ExperimentalDedicatedWorker::remove_WebMessageReceived

• ICoreWebView2ExperimentalDedicatedWorkerCreatedEventArgs
  • ICoreWebView2ExperimentalDedicatedWorkerCreatedEventArgs::get_OriginalSourceFrameInfo
  • ICoreWebView2ExperimentalDedicatedWorkerCreatedEventArgs::get_Worker

• ICoreWebView2ExperimentalDedicatedWorkerCreatedEventHandler

• ICoreWebView2ExperimentalDedicatedWorkerDedicatedWorkerCreatedEventHandler

• ICoreWebView2ExperimentalDedicatedWorkerDestroyingEventHandler

• ICoreWebView2ExperimentalDedicatedWorkerWebMessageReceivedEventHandler

• ICoreWebView2ExperimentalFrame9
  • ICoreWebView2ExperimentalFrame9::add_DedicatedWorkerCreated
  • ICoreWebView2ExperimentalFrame9::remove_DedicatedWorkerCreated

• ICoreWebView2ExperimentalFrameDedicatedWorkerCreatedEventHandler

• ICoreWebView2ExperimentalGetServiceWorkerRegistrationsCompletedHandler

• ICoreWebView2ExperimentalGetSharedWorkersCompletedHandler

• ICoreWebView2ExperimentalProfile13
  • ICoreWebView2ExperimentalProfile13::get_ServiceWorkerManager
  • ICoreWebView2ExperimentalProfile13::get_SharedWorkerManager

• ICoreWebView2ExperimentalServiceWorker
  • ICoreWebView2ExperimentalServiceWorker::add_Destroying
  • ICoreWebView2ExperimentalServiceWorker::add_WebMessageReceived
  • ICoreWebView2ExperimentalServiceWorker::get_ScriptUri
  • ICoreWebView2ExperimentalServiceWorker::PostWebMessageAsJson
  • ICoreWebView2ExperimentalServiceWorker::PostWebMessageAsString
  • ICoreWebView2ExperimentalServiceWorker::remove_Destroying
  • ICoreWebView2ExperimentalServiceWorker::remove_WebMessageReceived

• ICoreWebView2ExperimentalServiceWorkerActivatedEventArgs
  • ICoreWebView2ExperimentalServiceWorkerActivatedEventArgs::get_ActiveServiceWorker

• ICoreWebView2ExperimentalServiceWorkerActivatedEventHandler

• ICoreWebView2ExperimentalServiceWorkerDestroyingEventHandler

• ICoreWebView2ExperimentalServiceWorkerManager
  • ICoreWebView2ExperimentalServiceWorkerManager::add_ServiceWorkerRegistered
  • ICoreWebView2ExperimentalServiceWorkerManager::GetServiceWorkerRegistrations
  • ICoreWebView2ExperimentalServiceWorkerManager::GetServiceWorkerRegistrationsForScope
  • ICoreWebView2ExperimentalServiceWorkerManager::remove_ServiceWorkerRegistered

• ICoreWebView2ExperimentalServiceWorkerRegisteredEventArgs
  • ICoreWebView2ExperimentalServiceWorkerRegisteredEventArgs::get_ServiceWorkerRegistration

• ICoreWebView2ExperimentalServiceWorkerRegisteredEventHandler

• ICoreWebView2ExperimentalServiceWorkerRegistration
  • ICoreWebView2ExperimentalServiceWorkerRegistration::add_ServiceWorkerActivated
  • ICoreWebView2ExperimentalServiceWorkerRegistration::add_Unregistering
  • ICoreWebView2ExperimentalServiceWorkerRegistration::get_ActiveServiceWorker
  • ICoreWebView2ExperimentalServiceWorkerRegistration::get_Origin
  • ICoreWebView2ExperimentalServiceWorkerRegistration::get_ScopeUri
  • ICoreWebView2ExperimentalServiceWorkerRegistration::get_TopLevelOrigin
  • ICoreWebView2ExperimentalServiceWorkerRegistration::remove_ServiceWorkerActivated
  • ICoreWebView2ExperimentalServiceWorkerRegistration::remove_Unregistering

• ICoreWebView2ExperimentalServiceWorkerRegistrationCollectionView
  • ICoreWebView2ExperimentalServiceWorkerRegistrationCollectionView::get_Count
  • ICoreWebView2ExperimentalServiceWorkerRegistrationCollectionView::GetValueAtIndex

• ICoreWebView2ExperimentalServiceWorkerRegistrationUnregisteringEventHandler

• ICoreWebView2ExperimentalServiceWorkerWebMessageReceivedEventHandler

• ICoreWebView2ExperimentalSharedWorker
  • ICoreWebView2ExperimentalSharedWorker::add_Destroying
  • ICoreWebView2ExperimentalSharedWorker::get_Origin
  • ICoreWebView2ExperimentalSharedWorker::get_ScriptUri
  • ICoreWebView2ExperimentalSharedWorker::get_TopLevelOrigin
  • ICoreWebView2ExperimentalSharedWorker::remove_Destroying

• ICoreWebView2ExperimentalSharedWorkerCollectionView
  • ICoreWebView2ExperimentalSharedWorkerCollectionView::get_Count
  • ICoreWebView2ExperimentalSharedWorkerCollectionView::GetValueAtIndex

• ICoreWebView2ExperimentalSharedWorkerCreatedEventArgs
  • ICoreWebView2ExperimentalSharedWorkerCreatedEventArgs::get_Worker

• ICoreWebView2ExperimentalSharedWorkerCreatedEventHandler

• ICoreWebView2ExperimentalSharedWorkerDestroyingEventHandler

• ICoreWebView2ExperimentalSharedWorkerManager
  • ICoreWebView2ExperimentalSharedWorkerManager::add_SharedWorkerCreated
  • ICoreWebView2ExperimentalSharedWorkerManager::GetSharedWorkers
  • ICoreWebView2ExperimentalSharedWorkerManager::remove_SharedWorkerCreated

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.

.NET/C#

• CoreWebView2 Class:

  • CoreWebView2.WindowControlsOverlay Property

• CoreWebView2WindowControlsOverlay Class

  • CoreWebView2WindowControlsOverlay.IsEnabled Property
  • CoreWebView2WindowControlsOverlay.BackgroundColor Property
  • CoreWebView2WindowControlsOverlay.Height Property

WinRT/C#

• CoreWebView2 Class:

  • CoreWebView2.WindowControlsOverlay Property

• CoreWebView2WindowControlsOverlay Class

  • CoreWebView2WindowControlsOverlay.IsEnabled Property
  • CoreWebView2WindowControlsOverlay.BackgroundColor Property
  • CoreWebView2WindowControlsOverlay.Height Property

Win32/C++

• ICoreWebView2Experimental31

  • ICoreWebView2Experimental31::get_WindowControlsOverlay

• ICoreWebView2ExperimentalWindowControlsOverlay

  • ICoreWebView2ExperimentalWindowControlsOverlay::get_BackgroundColor
  • ICoreWebView2ExperimentalWindowControlsOverlay::get_Height
  • ICoreWebView2ExperimentalWindowControlsOverlay::get_IsEnabled
  • ICoreWebView2ExperimentalWindowControlsOverlay::put_BackgroundColor
  • ICoreWebView2ExperimentalWindowControlsOverlay::put_Height
  • ICoreWebView2ExperimentalWindowControlsOverlay::put_IsEnabled

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.

.NET/C#

• CoreWebView2 Class:

  • CoreWebView2.Find Property

• CoreWebView2Environment Class:

  • CoreWebView2Environment.CreateFindOptions Method

• CoreWebView2Find Class

  • CoreWebView2Find.ActiveMatchIndex Property
  • CoreWebView2Find.ActiveMatchIndexChanged Event
  • CoreWebView2Find.FindNext Method
  • CoreWebView2Find.FindPrevious Method
  • CoreWebView2Find.MatchCount Property
  • CoreWebView2Find.MatchCountChanged Event
  • CoreWebView2Find.StartAsync Method
  • CoreWebView2Find.Stop Method

• CoreWebView2FindOptions Class

  • CoreWebView2FindOptions.FindTerm Property
  • CoreWebView2FindOptions.IsCaseSensitive Property
  • CoreWebView2FindOptions.ShouldHighlightAllMatches Property
  • CoreWebView2FindOptions.ShouldMatchWord Property
  • CoreWebView2FindOptions.SuppressDefaultFindDialog Property

WinRT/C#

• CoreWebView2 Class:

  • CoreWebView2.Find Property

• CoreWebView2Environment Class:

  • CoreWebView2Environment.CreateFindOptions Property

• CoreWebView2Find Class

  • CoreWebView2Find.ActiveMatchIndex Property
  • CoreWebView2Find.ActiveMatchIndexChanged Event
  • CoreWebView2Find.FindNext Property
  • CoreWebView2Find.FindPrevious Property
  • CoreWebView2Find.MatchCount Property
  • CoreWebView2Find.MatchCountChanged Event
  • CoreWebView2Find.StartAsync Property

• CoreWebView2FindOptions Class

  • CoreWebView2FindOptions.FindTerm Property
  • CoreWebView2FindOptions.IsCaseSensitive Property
  • CoreWebView2FindOptions.ShouldHighlightAllMatches Property
  • CoreWebView2FindOptions.ShouldMatchWord Property
  • CoreWebView2FindOptions.SuppressDefaultFindDialog Property

Win32/C++

• ICoreWebView2_28

  • ICoreWebView2_28::get_Find

• ICoreWebView2Environment15

  • ICoreWebView2Environment15::CreateFindOptions

• ICoreWebView2Find

  • ICoreWebView2Find::add_ActiveMatchIndexChanged
  • ICoreWebView2Find::add_MatchCountChanged
  • ICoreWebView2Find::FindNext
  • ICoreWebView2Find::FindPrevious
  • ICoreWebView2Find::get_ActiveMatchIndex
  • ICoreWebView2Find::get_MatchCount
  • ICoreWebView2Find::remove_ActiveMatchIndexChanged
  • ICoreWebView2Find::remove_MatchCountChanged
  • ICoreWebView2Find::Start
  • ICoreWebView2Find::Stop

• ICoreWebView2FindActiveMatchIndexChangedEventHandler

• ICoreWebView2FindMatchCountChangedEventHandler

• ICoreWebView2FindOptions

  • ICoreWebView2FindOptions::get_FindTerm
  • ICoreWebView2FindOptions::get_IsCaseSensitive
  • ICoreWebView2FindOptions::get_ShouldHighlightAllMatches
  • ICoreWebView2FindOptions::get_ShouldMatchWord
  • ICoreWebView2FindOptions::get_SuppressDefaultFindDialog
  • ICoreWebView2FindOptions::put_FindTerm
  • ICoreWebView2FindOptions::put_IsCaseSensitive
  • ICoreWebView2FindOptions::put_ShouldHighlightAllMatches
  • ICoreWebView2FindOptions::put_ShouldMatchWord
  • ICoreWebView2FindOptions::put_SuppressDefaultFindDialog

• ICoreWebView2FindStartCompletedHandler

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.

.NET/C#

• CoreWebView2ControllerOptions Class:
  • CoreWebView2ControllerOptions.DefaultBackgroundColor Property

WinRT/C#

• CoreWebView2ControllerOptions Class:
  • CoreWebView2ControllerOptions.DefaultBackgroundColor Property

Win32/C++

• ICoreWebView2ControllerOptions3
  • ICoreWebView2ControllerOptions3::get_DefaultBackgroundColor
  • ICoreWebView2ControllerOptions3::put_DefaultBackgroundColor

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.

.NET/C#

• CoreWebView2ControllerOptions Class:
  • CoreWebView2ControllerOptions.AllowHostInputProcessing Property

WinRT/C#

• CoreWebView2ControllerOptions Class:
  • CoreWebView2ControllerOptions.AllowHostInputProcessing Property

Win32/C++

• ICoreWebView2ControllerOptions4
  • ICoreWebView2ControllerOptions4::get_AllowHostInputProcessing
  • ICoreWebView2ControllerOptions4::put_AllowHostInputProcessing

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.

.NET/C#

• CoreWebView2Frame Class:
  • CoreWebView2Frame.FrameCreated Event

WinRT/C#

• CoreWebView2Frame Class:
  • CoreWebView2Frame.FrameCreated Event

Win32/C++

• ICoreWebView2Frame7

  • ICoreWebView2Frame7::add_FrameCreated
  • ICoreWebView2Frame7::remove_FrameCreated

• ICoreWebView2FrameChildFrameCreatedEventHandler

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.

.NET/C#

• CoreWebView2ControllerOptions Class:
  • CoreWebView2ControllerOptions.DefaultBackgroundColor Property

WinRT/C#

• CoreWebView2ControllerOptions Class:
  • CoreWebView2ControllerOptions.DefaultBackgroundColor Property

Win32/C++

• ICoreWebView2ControllerOptions3
  • ICoreWebView2ControllerOptions3::get_DefaultBackgroundColor
  • ICoreWebView2ControllerOptions3::put_DefaultBackgroundColor

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.

.NET/C#

• CoreWebView2Frame Class:
  • CoreWebView2Frame.FrameCreated Event

WinRT/C#

• CoreWebView2Frame Class:
  • CoreWebView2Frame.FrameCreated Event

Win32/C++

• ICoreWebView2Frame7

  • ICoreWebView2Frame7::add_FrameCreated
  • ICoreWebView2Frame7::remove_FrameCreated

• ICoreWebView2FrameChildFrameCreatedEventHandler

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.

See also

• About Release Notes for the WebView2 SDK
• Archived Release Notes for the WebView2 SDK
• Overview of WebView2 APIs - outlines many of the APIs, by feature area, that are in Release SDK packages.
• Contacting the Microsoft Edge WebView2 team
• Release notes for Microsoft Edge web platform

API Reference:

• WebView2 API Reference
  • .NET: Microsoft.Web.WebView2.Core Namespace
  • WinRT: Microsoft.Web.WebView2.Core Namespace
  • Win32: Reference (WebView2 Win32 C++)