WebView2 Release Notes for Dec. 2025 SDKs #3635

mikehoffms · 2025-11-10T19:47:42Z

Rendered article sections for review:

Release Notes for the WebView2 SDK
- 1.0.3650.58
  - /webview2/release-notes/index.md
  - Internal preview: https://review.learn.microsoft.com/microsoft-edge/webview2/release-notes/index?branch=pr-en-us-3635#10365058
  - External preview: https://github.com/MicrosoftDocs/edge-developer/blob/user/mikehoffms/wv2-relnotes-dec-2025/microsoft-edge/webview2/release-notes/index.md#10365058
  - Planned live: https://learn.microsoft.com/microsoft-edge/webview2/release-notes/#10365058
  - New section.
- 1.0.3712-prerelease
  - /webview2/release-notes/index.md
  - Internal preview: https://review.learn.microsoft.com/microsoft-edge/webview2/release-notes/index?branch=pr-en-us-3635#103712-prerelease
  - External preview: https://github.com/MicrosoftDocs/edge-developer/blob/user/mikehoffms/wv2-relnotes-dec-2025/microsoft-edge/webview2/release-notes/index.md#103712-prerelease
  - Planned live: https://learn.microsoft.com/microsoft-edge/webview2/release-notes/#103712-prerelease
  - New section.

Incidental files

Archived Release Notes for the WebView2 SDK
- /webview2/release-notes/archive.md
- Internal preview: https://review.learn.microsoft.com/microsoft-edge/webview2/release-notes/archive?branch=pr-en-us-3635
- External preview: https://github.com/MicrosoftDocs/edge-developer/blob/user/mikehoffms/wv2-relnotes-dec-2025/microsoft-edge/webview2/release-notes/archive.md
- Before/live: https://learn.microsoft.com/microsoft-edge/webview2/release-notes/archive
- Moved June 2025 sections from index to archive.
templates for WebView2 RelNotes
- /webview2/release-notes/includes/templates.md
- Internal preview: n/a
- External preview: https://github.com/MicrosoftDocs/edge-developer/blob/user/mikehoffms/wv2-relnotes-dec-2025/microsoft-edge/webview2/release-notes/includes/templates.md
- Before/live: https://github.com/MicrosoftDocs/edge-developer/blob/live/microsoft-edge/webview2/release-notes/includes/templates.md
- Updated month to next month.
- Made NuGet placeholder links not 404.
Web platform release notes
- /web-platform/release-notes/133.md
- /web-platform/release-notes/134.md
- /web-platform/release-notes/135.md
- /web-platform/release-notes/136.md
- /web-platform/release-notes/137.md
- /web-platform/release-notes/138.md
- /web-platform/release-notes/139.md
- /web-platform/release-notes/140.md
- /web-platform/release-notes/141.md
- /web-platform/release-notes/142.md
- /web-platform/release-notes/143.md
- Internal preview: https://review.learn.microsoft.com/microsoft-edge/web-platform/release-notes/143?branch=pr-en-us-3635
- External preview: https://github.com/MicrosoftDocs/edge-developer/blob/user/mikehoffms/wv2-relnotes-dec-2025/microsoft-edge/web-platform/release-notes/143.md
- Before/live: https://learn.microsoft.com/microsoft-edge/web-platform/release-notes/143
- Showed day of month next to link to WebView2 RelNotes.
Overview of WebView2 APIs > Default background color
- /webview2/concepts/overview-features-apis.md
- Internal preview: https://review.learn.microsoft.com/microsoft-edge/webview2/concepts/overview-features-apis?branch=pr-en-us-3635#default-background-color
- External preview: https://github.com/MicrosoftDocs/edge-developer/blob/user/mikehoffms/wv2-relnotes-dec-2025/microsoft-edge/webview2/concepts/overview-features-apis.md#default-background-color
- Before/live: https://learn.microsoft.com/microsoft-edge/webview2/concepts/overview-features-apis#default-background-color
- Updated link from index.md to archive.md.

AB#60132072

microsoft-edge/webview2/release-notes/index.md

microsoft-edge/webview2/release-notes/archive.md

learn-build-service-prod · 2025-12-05T19:17:07Z

Learn Build status updates of commit 8613d1d:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
microsoft-edge/webview2/release-notes/about.md	⚠️Warning	View	Details
microsoft-edge/webview2/release-notes/index.md	💡Suggestion	View	Details
microsoft-edge/web-platform/release-notes/133.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/134.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/135.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/136.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/137.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/138.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/139.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/140.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/141.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/142.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/143.md	✅Succeeded	View
microsoft-edge/webview2/concepts/overview-features-apis.md	✅Succeeded	View
microsoft-edge/webview2/release-notes/archive.md	✅Succeeded	View
microsoft-edge/webview2/release-notes/includes/templates.md	✅Succeeded

microsoft-edge/webview2/release-notes/about.md

Line 57, Column 6: [Warning: file-not-found - See documentation] Invalid file link: '../concepts/versioning'.

microsoft-edge/webview2/release-notes/index.md

Line 96, Column 3: [Suggestion: learn-site-link-broken - See documentation] Link '/dotnet/api/microsoft.web.webview2.core.corewebview2allowedportrangescope?view=webview2-dotnet-1.0.3712-prerelease&preserve-view=true' points to a learn site page that doesn't exist. Check the path or URL and update the link.
Line 101, Column 6: [Suggestion: learn-site-link-broken - See documentation] Link '/dotnet/api/microsoft.web.webview2.core.corewebview2environmentoptions.geteffectiveallowedportrange?view=webview2-dotnet-1.0.3712-prerelease&preserve-view=true' points to a learn site page that doesn't exist. Check the path or URL and update the link.
Line 102, Column 6: [Suggestion: learn-site-link-broken - See documentation] Link '/dotnet/api/microsoft.web.webview2.core.corewebview2environmentoptions.setallowedportrange?view=webview2-dotnet-1.0.3712-prerelease&preserve-view=true' points to a learn site page that doesn't exist. Check the path or URL and update the link.
Line 104, Column 3: [Suggestion: learn-site-link-broken - See documentation] Link '/dotnet/api/microsoft.web.webview2.core.corewebview2transportprotocolkind?view=webview2-dotnet-1.0.3712-prerelease&preserve-view=true' points to a learn site page that doesn't exist. Check the path or URL and update the link.
Line 153, Column 3: [Suggestion: learn-site-link-broken - See documentation] Link '/microsoft-edge/webview2/reference/win32/icorewebview2compositioncontroller5?view=webview2-1.0.3712-prerelease&preserve-view=true' points to a learn site page that doesn't exist. Check the path or URL and update the link.
Line 154, Column 5: [Suggestion: learn-site-link-broken - See documentation] Link '/microsoft-edge/webview2/reference/win32/icorewebview2compositioncontroller5?view=webview2-1.0.3712-prerelease&preserve-view=true#add_dragstarting' points to a learn site page that doesn't exist. Check the path or URL and update the link.
Line 155, Column 5: [Suggestion: learn-site-link-broken - See documentation] Link '/microsoft-edge/webview2/reference/win32/icorewebview2compositioncontroller5?view=webview2-1.0.3712-prerelease&preserve-view=true#remove_dragstarting' points to a learn site page that doesn't exist. Check the path or URL and update the link.
Line 157, Column 3: [Suggestion: learn-site-link-broken - See documentation] Link '/microsoft-edge/webview2/reference/win32/icorewebview2compositioncontrollerinterop3?view=webview2-1.0.3712-prerelease&preserve-view=true' points to a learn site page that doesn't exist. Check the path or URL and update the link.
Line 158, Column 5: [Suggestion: learn-site-link-broken - See documentation] Link '/microsoft-edge/webview2/reference/win32/icorewebview2compositioncontrollerinterop3?view=webview2-1.0.3712-prerelease&preserve-view=true#add_dragstarting' points to a learn site page that doesn't exist. Check the path or URL and update the link.
Line 159, Column 5: [Suggestion: learn-site-link-broken - See documentation] Link '/microsoft-edge/webview2/reference/win32/icorewebview2compositioncontrollerinterop3?view=webview2-1.0.3712-prerelease&preserve-view=true#remove_dragstarting' points to a learn site page that doesn't exist. Check the path or URL and update the link.
Line 161, Column 3: [Suggestion: learn-site-link-broken - See documentation] Link '/microsoft-edge/webview2/reference/win32/icorewebview2dragstartingeventargs?view=webview2-1.0.3712-prerelease&preserve-view=true' points to a learn site page that doesn't exist. Check the path or URL and update the link.
Line 162, Column 5: [Suggestion: learn-site-link-broken - See documentation] Link '/microsoft-edge/webview2/reference/win32/icorewebview2dragstartingeventargs?view=webview2-1.0.3712-prerelease&preserve-view=true#get_alloweddropeffects' points to a learn site page that doesn't exist. Check the path or URL and update the link.
Line 163, Column 5: [Suggestion: learn-site-link-broken - See documentation] Link '/microsoft-edge/webview2/reference/win32/icorewebview2dragstartingeventargs?view=webview2-1.0.3712-prerelease&preserve-view=true#get_data' points to a learn site page that doesn't exist. Check the path or URL and update the link.
Line 164, Column 5: [Suggestion: learn-site-link-broken - See documentation] Link '/microsoft-edge/webview2/reference/win32/icorewebview2dragstartingeventargs?view=webview2-1.0.3712-prerelease&preserve-view=true#get_handled' points to a learn site page that doesn't exist. Check the path or URL and update the link.
Line 165, Column 5: [Suggestion: learn-site-link-broken - See documentation] Link '/microsoft-edge/webview2/reference/win32/icorewebview2dragstartingeventargs?view=webview2-1.0.3712-prerelease&preserve-view=true#get_position' points to a learn site page that doesn't exist. Check the path or URL and update the link.
Line 166, Column 5: [Suggestion: learn-site-link-broken - See documentation] Link '/microsoft-edge/webview2/reference/win32/icorewebview2dragstartingeventargs?view=webview2-1.0.3712-prerelease&preserve-view=true#getdeferral' points to a learn site page that doesn't exist. Check the path or URL and update the link.
Line 167, Column 5: [Suggestion: learn-site-link-broken - See documentation] Link '/microsoft-edge/webview2/reference/win32/icorewebview2dragstartingeventargs?view=webview2-1.0.3712-prerelease&preserve-view=true#put_handled' points to a learn site page that doesn't exist. Check the path or URL and update the link.
Line 169, Column 3: [Suggestion: learn-site-link-broken - See documentation] Link '/microsoft-edge/webview2/reference/win32/icorewebview2dragstartingeventhandler?view=webview2-1.0.3712-prerelease&preserve-view=true' points to a learn site page that doesn't exist. Check the path or URL and update the link.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

Ju-MsGit · 2025-12-08T14:01:25Z

@mikehoffms/@vootlasaichandu - As the ref docs PR are merged now, can you please validate the links in rel note for which we were facing 404s?

microsoft-edge/webview2/release-notes/index.md

learn-build-service-prod · 2025-12-08T17:24:38Z

Learn Build status updates of commit d0596c9:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
microsoft-edge/webview2/release-notes/about.md	⚠️Warning	View	Details
microsoft-edge/webview2/release-notes/index.md	💡Suggestion	View	Details
microsoft-edge/web-platform/release-notes/133.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/134.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/135.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/136.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/137.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/138.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/139.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/140.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/141.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/142.md	✅Succeeded	View
microsoft-edge/web-platform/release-notes/143.md	✅Succeeded	View
microsoft-edge/webview2/concepts/overview-features-apis.md	✅Succeeded	View
microsoft-edge/webview2/release-notes/archive.md	✅Succeeded	View
microsoft-edge/webview2/release-notes/includes/templates.md	✅Succeeded

microsoft-edge/webview2/release-notes/about.md

Line 57, Column 6: [Warning: file-not-found - See documentation] Invalid file link: '../concepts/versioning'.

microsoft-edge/webview2/release-notes/index.md

Line 97, Column 6: [Suggestion: learn-site-link-broken - See documentation] Link '/dotnet/api/microsoft.web.webview2.core.corewebview2environmentoptions.geteffectiveallowedportrange?view=webview2-dotnet-1.0.3712-prerelease&preserve-view=true' points to a learn site page that doesn't exist. Check the path or URL and update the link.
Line 98, Column 6: [Suggestion: learn-site-link-broken - See documentation] Link '/dotnet/api/microsoft.web.webview2.core.corewebview2environmentoptions.setallowedportrange?view=webview2-dotnet-1.0.3712-prerelease&preserve-view=true' points to a learn site page that doesn't exist. Check the path or URL and update the link.
Line 100, Column 3: [Suggestion: learn-site-link-broken - See documentation] Link '/dotnet/api/microsoft.web.webview2.core.corewebview2allowedportrangescope?view=webview2-dotnet-1.0.3712-prerelease&preserve-view=true' points to a learn site page that doesn't exist. Check the path or URL and update the link.
Line 104, Column 3: [Suggestion: learn-site-link-broken - See documentation] Link '/dotnet/api/microsoft.web.webview2.core.corewebview2transportprotocolkind?view=webview2-dotnet-1.0.3712-prerelease&preserve-view=true' points to a learn site page that doesn't exist. Check the path or URL and update the link.
Line 157, Column 3: [Suggestion: learn-site-link-broken - See documentation] Link '/microsoft-edge/webview2/reference/win32/icorewebview2compositioncontrollerinterop3?view=webview2-1.0.3712-prerelease&preserve-view=true' points to a learn site page that doesn't exist. Check the path or URL and update the link.
Line 158, Column 5: [Suggestion: learn-site-link-broken - See documentation] Link '/microsoft-edge/webview2/reference/win32/icorewebview2compositioncontrollerinterop3?view=webview2-1.0.3712-prerelease&preserve-view=true#add_dragstarting' points to a learn site page that doesn't exist. Check the path or URL and update the link.
Line 159, Column 5: [Suggestion: learn-site-link-broken - See documentation] Link '/microsoft-edge/webview2/reference/win32/icorewebview2compositioncontrollerinterop3?view=webview2-1.0.3712-prerelease&preserve-view=true#remove_dragstarting' points to a learn site page that doesn't exist. Check the path or URL and update the link.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

Ju-MsGit

LGTM - Dev

vootlasaichandu

LGTM - PM

mikehoffms

LGTM - Writer/Editor.
7 alleged 404s. 4 .NET (no PRs created yet). 3 Win32 (different type; PR not rendering live yet). Will test after live, and if needed, fix via later PR.

templates

f744ca5

MicrosoftDocs deleted a comment from learn-build-service-prod bot Nov 10, 2025

linkfix

c91771e

MicrosoftDocs deleted a comment from learn-build-service-prod bot Nov 10, 2025

mikehoffms requested review from ojasvi1450 and vootlasaichandu November 10, 2025 21:51

mikehoffms added in-progress cat: webview2 WebView-related content. labels Nov 10, 2025

MicrosoftDocs deleted a comment from learn-build-service-prod bot Nov 10, 2025

mikehoffms added 2 commits November 13, 2025 17:35

Merge branch 'main' into user/mikehoffms/wv2-relnotes-dec-2025

70c6b45

Merge branch 'main' into user/mikehoffms/wv2-relnotes-dec-2025

09d980d

MicrosoftDocs deleted a comment from learn-build-service-prod bot Nov 26, 2025

draft

93d3228

mikehoffms removed the in-progress label Dec 2, 2025

mikehoffms marked this pull request as ready for review December 2, 2025 20:25

mikehoffms commented Dec 2, 2025

View reviewed changes

microsoft-edge/webview2/release-notes/index.md Outdated Show resolved Hide resolved

cleanup Prerelease APIs

a99e500

mikehoffms commented Dec 2, 2025

View reviewed changes

microsoft-edge/webview2/release-notes/index.md Outdated Show resolved Hide resolved

mikehoffms commented Dec 2, 2025

View reviewed changes

microsoft-edge/webview2/release-notes/index.md Outdated Show resolved Hide resolved

mikehoffms commented Dec 2, 2025

View reviewed changes

microsoft-edge/webview2/release-notes/index.md Outdated Show resolved Hide resolved

mikehoffms commented Dec 2, 2025

View reviewed changes

microsoft-edge/webview2/release-notes/index.md Outdated Show resolved Hide resolved

mikehoffms commented Dec 2, 2025

View reviewed changes

microsoft-edge/webview2/release-notes/index.md Outdated Show resolved Hide resolved

mikehoffms requested review from Ju-MsGit and removed request for ojasvi1450 December 2, 2025 22:44

mikehoffms added 2 commits December 2, 2025 14:51

not Gen changes

dabe875

links for sec to del

9df2b4f

MicrosoftDocs deleted a comment from learn-build-service-prod bot Dec 2, 2025

mikehoffms commented Dec 5, 2025

View reviewed changes

microsoft-edge/webview2/release-notes/index.md Outdated Show resolved Hide resolved

mikehoffms commented Dec 5, 2025

View reviewed changes

microsoft-edge/webview2/release-notes/archive.md Outdated Show resolved Hide resolved

mikehoffms added 2 commits December 5, 2025 10:53

phase headings

7d8f3b7

linkfix

8613d1d

Ju-MsGit reviewed Dec 8, 2025

View reviewed changes

microsoft-edge/webview2/release-notes/index.md Outdated Show resolved Hide resolved

Ju-MsGit reviewed Dec 8, 2025

View reviewed changes

microsoft-edge/webview2/release-notes/index.md Outdated Show resolved Hide resolved

Ju-MsGit reviewed Dec 8, 2025

View reviewed changes

microsoft-edge/webview2/release-notes/index.md Show resolved Hide resolved

mikehoffms commented Dec 8, 2025

View reviewed changes

microsoft-edge/webview2/release-notes/index.md Show resolved Hide resolved

MicrosoftDocs deleted a comment from learn-build-service-prod bot Dec 8, 2025

inc rvw

d0596c9

MicrosoftDocs deleted a comment from learn-build-service-prod bot Dec 8, 2025

mikehoffms requested a review from Ju-MsGit December 8, 2025 17:23

Ju-MsGit approved these changes Dec 8, 2025

View reviewed changes

vootlasaichandu approved these changes Dec 8, 2025

View reviewed changes

mikehoffms commented Dec 8, 2025

View reviewed changes

mikehoffms merged commit 697bb09 into main Dec 8, 2025
3 checks passed

mikehoffms deleted the user/mikehoffms/wv2-relnotes-dec-2025 branch December 8, 2025 18:11

mikehoffms mentioned this pull request Dec 8, 2025

main to live - December 8, 2025 #3659

Merged

WebView2 Release Notes for Dec. 2025 SDKs #3635

WebView2 Release Notes for Dec. 2025 SDKs #3635

Uh oh!

Conversation

mikehoffms commented Nov 10, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Incidental files

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

learn-build-service-prod bot commented Dec 5, 2025

⚠️ Validation status: warnings

microsoft-edge/webview2/release-notes/about.md

microsoft-edge/webview2/release-notes/index.md

Uh oh!

Ju-MsGit commented Dec 8, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

learn-build-service-prod bot commented Dec 8, 2025

⚠️ Validation status: warnings

microsoft-edge/webview2/release-notes/about.md

microsoft-edge/webview2/release-notes/index.md

Uh oh!

Ju-MsGit left a comment

Choose a reason for hiding this comment

Uh oh!

vootlasaichandu left a comment

Choose a reason for hiding this comment

Uh oh!

mikehoffms left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

mikehoffms commented Nov 10, 2025 •

edited

Loading