index.md

title	description	author	ms.author	ms.topic	ms.service	ms.subservice	ms.date
Release Notes for the WebView2 SDK	Release notes for Microsoft Edge WebView2, covering new features, APIs, and fixes for Win32, WPF, and WinForms.	MSEdgeTeam	msedgedevrel	conceptual	microsoft-edge	webview	04/07/2025

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

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)

.NET/C#

• CoreWebView2Find.FindNext Method

WinRT/C#

• CoreWebView2Find.FindNext Property

Win32/C++

• ICoreWebView2ExperimentalFind::FindNext

---

1.0.2957.106

Release Date: January 20, 2025

NuGet package for WebView2 SDK 1.0.2957.106

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

Promotions

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

Show WPF elements on top of the WebView2 layer (WebView2CompositionControl)

The WebView2CompositionControl prevents the WebView2 control from being the topmost layer in a WPF app and obscuring any WPF elements. Microsoft.Web.WebView2.Wpf.WebView2CompositionControl is a drop-in replacement for the standard WPF WebView2 control. Both the WebView2 control and WebView2CompositionControl implement the Microsoft.Web.WebView2.Wpf.IWebView2 interface. Both of them derive from FrameworkElement, as follows:

• FrameworkElement -> HwndHost -> WebView2.
• FrameworkElement -> Control -> WebView2CompositionControl.

Background: If you're building a Windows Presentation Foundation (WPF) app and using the WebView2 control, you may find that your app runs into "airspace" issues, where the WebView2 control is always displayed on top, hiding any WPF elements in the same location, even if you try to specify the WPF elements to be above the WebView2 control (using visual tree order or the z-index property, for example).

This issue occurs because the WPF control uses the WPF HwndHost to host the Win32 WebView2 control, and HwndHost has an issue with airspace.

See also:

• Mitigating Airspace Issues In WPF Applications
• WPF Airspace - WebView2CompositionControl - Spec.

.NET/C#

• WebView2CompositionControl Class

WinRT/C#

n/a

Win32/C++

n/a

---

Bug fixes

Runtime-only

• Fixed a regression where display changes can cause WebView2 to render smaller than the app window.

SDK-only

• Fixed an issue in the WPF WebView2CompositionControl where it's not displayed if it's initialized with size (0,0), such as when it's initialized in a TabItem of a TabControl. (Issue #4941)

1.0.3079-prerelease

Release Date: January 24, 2025

NuGet package for WebView2 SDK 1.0.3079-prerelease

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

Experimental APIs

The following Experimental APIs have been added 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 are actively investigating these issues, and we encourage you to report any problems you encounter, by using the WebView2Feedback repo.

.NET/C#

• CoreWebView2.Find Property

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

• ICoreWebView2Experimental29

  • ICoreWebView2Experimental29::get_Find

• ICoreWebView2ExperimentalEnvironment18

  • ICoreWebView2ExperimentalEnvironment18::CreateFindOptions

• ICoreWebView2ExperimentalFind

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

• ICoreWebView2ExperimentalFindActiveMatchIndexChangedEventHandler

• ICoreWebView2ExperimentalFindMatchCountChangedEventHandler

• ICoreWebView2ExperimentalFindOptions

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

• ICoreWebView2ExperimentalFindStartCompletedHandler

---

Customize the drag and drop behavior (DragStarting API)

The DragStarting API overrides the default drag and drop behavior when running in visual hosting mode. The DragStarting event notifies your app when the user starts a drag operation in the WebView2, and provides the state that's necessary to override the default WebView2 drag operation with your own logic.

• Use DragStarting on the ICoreWebView2ExperimentalCompositionController6 to add an event handler that's invoked when the drag operation is starting.
• Use ICoreWebView2ExperimentalDragStartingEventArgs to start your own drag operation.
  • Use the GetDeferral method to execute any async drag logic and call back into the WebView at a later time.
  • Use the Handled property to let the WebView2 know whether to use its own drag logic.

.NET/C#

n/a

WinRT/C#

n/a

Win32/C++

• ICoreWebView2ExperimentalCompositionController6

  • ICoreWebView2ExperimentalCompositionController6::add_DragStarting
  • ICoreWebView2ExperimentalCompositionController6::remove_DragStarting

• ICoreWebView2ExperimentalCompositionControllerInterop3

  • ICoreWebView2ExperimentalCompositionControllerInterop3::add_DragStarting
  • ICoreWebView2ExperimentalCompositionControllerInterop3::remove_DragStarting

• ICoreWebView2ExperimentalDragStartingEventArgs

  • ICoreWebView2ExperimentalDragStartingEventArgs::get_AllowedDropEffects
  • ICoreWebView2ExperimentalDragStartingEventArgs::get_Data
  • ICoreWebView2ExperimentalDragStartingEventArgs::get_Handled
  • ICoreWebView2ExperimentalDragStartingEventArgs::get_Position
  • ICoreWebView2ExperimentalDragStartingEventArgs::GetDeferral
  • ICoreWebView2ExperimentalDragStartingEventArgs::put_Handled

• ICoreWebView2ExperimentalDragStartingEventHandler

---

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

• ICoreWebView2ExperimentalFrame8

  • ICoreWebView2ExperimentalFrame8::add_FrameCreated
  • ICoreWebView2ExperimentalFrame8::remove_FrameCreated

• ICoreWebView2ExperimentalFrameChildFrameCreatedEventHandler

---

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

• ICoreWebView2ExperimentalControllerOptions3
  • ICoreWebView2ExperimentalControllerOptions3::get_DefaultBackgroundColor
  • ICoreWebView2ExperimentalControllerOptions3::put_DefaultBackgroundColor

---

Promotions

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

Show WPF elements on top of the WebView2 layer (WebView2CompositionControl)

The WebView2CompositionControl prevents the WebView2 control from being the topmost layer in a WPF app and obscuring any WPF elements. Microsoft.Web.WebView2.Wpf.WebView2CompositionControl is a drop-in replacement for the standard WPF WebView2 control. Both the WebView2 control and WebView2CompositionControl implement the Microsoft.Web.WebView2.Wpf.IWebView2 interface. Both of them derive from FrameworkElement, as follows:

• FrameworkElement -> HwndHost -> WebView2.
• FrameworkElement -> Control -> WebView2CompositionControl.

Background: If you're building a Windows Presentation Foundation (WPF) app and using the WebView2 control, you may find that your app runs into "airspace" issues, where the WebView2 control is always displayed on top, hiding any WPF elements in the same location, even if you try to specify the WPF elements to be above the WebView2 control (using visual tree order or the z-index property, for example).

This issue occurs because the WPF control uses the WPF HwndHost to host the Win32 WebView2 control, and HwndHost has an issue with airspace.

See also:

• Mitigating Airspace Issues In WPF Applications
• WPF Airspace - WebView2CompositionControl - Spec.

.NET/C#

• WebView2CompositionControl Class

WinRT/C#

n/a

Win32/C++

n/a

---

Bug fixes

Runtime-only

• Fixed a regression where display changes can cause WebView2 to render smaller than app window.
• Enabled the IsolateSandboxedIframes upstream feature for WebView2.
• Prevented deleting a service worker when the version changes.
• The CleanUpSome API in Hostobject now only does garbage collection for the full heap. CleanUpSome has been removed from the V8 engine.
• Fixed a regression of AreBrowserAcceleratorKeysEnabled. (Issue #5033)
• Fixed a bug where IsDefaultDownloadDialogOpenChanged wasn't triggered when a dialog is closed by using the keyboard. (Issue #4807)

SDK-only

• Fixed an issue in the WPF WebView2CompositionControl where it's not displayed if it's initialized with size (0,0), such as when it's initialized in a TabItem of a TabControl. (Issue #4941)

1.0.2903.40

Release Date: November 18, 2024

NuGet package for WebView2 SDK 1.0.2903.40

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

Promotions

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

Control whether the screen capture UI is shown (ScreenCaptureStarting event)

Added a new ScreenCaptureStarting event. This event is raised whenever the WebView2 and/or iframe that corresponds to the CoreWebView2Frame (or to any of its descendant iframes) requests permission to use the Screen Capture API before the UI is shown. The app can then block the UI from being displayed, or allow the UI to be displayed.

.NET/C#

• CoreWebView2 Class:

  • CoreWebView2.ScreenCaptureStarting Event

• CoreWebView2Frame Class:

  • CoreWebView2Frame.ScreenCaptureStarting Event

• CoreWebView2NonClientRegionKind Enum:

  • CoreWebView2NonClientRegionKind.Minimize
  • CoreWebView2NonClientRegionKind.Maximize
  • CoreWebView2NonClientRegionKind.Close

• CoreWebView2ScreenCaptureStartingEventArgs Class

  • CoreWebView2ScreenCaptureStartingEventArgs.Cancel Property
  • CoreWebView2ScreenCaptureStartingEventArgs.Handled Property
  • CoreWebView2ScreenCaptureStartingEventArgs.OriginalSourceFrameInfo Property
  • CoreWebView2ScreenCaptureStartingEventArgs.GetDeferral Method

WinRT/C#

• CoreWebView2 Class:

  • CoreWebView2.ScreenCaptureStarting Event

• CoreWebView2Frame Class:

  • CoreWebView2Frame.ScreenCaptureStarting Event

• CoreWebView2NonClientRegionKind Enum:

  • CoreWebView2NonClientRegionKind.Minimize
  • CoreWebView2NonClientRegionKind.Maximize
  • CoreWebView2NonClientRegionKind.Close

• CoreWebView2ScreenCaptureStartingEventArgs Class

  • CoreWebView2ScreenCaptureStartingEventArgs.Cancel Property
  • CoreWebView2ScreenCaptureStartingEventArgs.Handled Property
  • CoreWebView2ScreenCaptureStartingEventArgs.OriginalSourceFrameInfo Property
  • CoreWebView2ScreenCaptureStartingEventArgs.GetDeferral Method

Win32/C++

• ICoreWebView2_27

  • ICoreWebView2_27::add_ScreenCaptureStarting
  • ICoreWebView2_27::remove_ScreenCaptureStarting

• ICoreWebView2Frame6

  • ICoreWebView2Frame6::add_ScreenCaptureStarting
  • ICoreWebView2Frame6::remove_ScreenCaptureStarting

• ICoreWebView2FrameScreenCaptureStartingEventHandler

• ICoreWebView2ScreenCaptureStartingEventArgs

  • ICoreWebView2ScreenCaptureStartingEventArgs::get_Cancel
  • ICoreWebView2ScreenCaptureStartingEventArgs::get_Handled
  • ICoreWebView2ScreenCaptureStartingEventArgs::get_OriginalSourceFrameInfo
  • ICoreWebView2ScreenCaptureStartingEventArgs::GetDeferral
  • ICoreWebView2ScreenCaptureStartingEventArgs::put_Cancel
  • ICoreWebView2ScreenCaptureStartingEventArgs::put_Handled

• ICoreWebView2ScreenCaptureStartingEventHandler

• COREWEBVIEW2_NON_CLIENT_REGION_KIND enum:

  • COREWEBVIEW2_NON_CLIENT_REGION_KIND_MINIMIZE
  • COREWEBVIEW2_NON_CLIENT_REGION_KIND_MAXIMIZE
  • COREWEBVIEW2_NON_CLIENT_REGION_KIND_CLOSE

---

Bug fixes

Runtime-only

• Allowed the Download dialog to receive initial focus on launch.

General changes

• The Microsoft Edge WebView2 Runtime is no longer listed in Windows Settings > Apps > Installed apps, because it is a persistent system component.

1.0.2950-prerelease

Release Date: November 18, 2024

NuGet package for WebView2 SDK 1.0.2950-prerelease

For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 132.0.2950.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

• Allowed the Download dialog to receive initial focus on launch.
• Fixed a crash while cancelling navigation to certain sites in FrameNavigationStarting. (Issue #4843)
• Postponed customizing the context menu when the touch selection menu is being displayed. (Issue #4737)

SDK-only

• Added Arm64ec support.
• Fixed an issue where WebView2 running in "Window to Visual" mode couldn't receive accelerator input.

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