From 84fba685c2acecce338b36ff2aab633c7306f40f Mon Sep 17 00:00:00 2001
From: Bob Arnson <bob@firegiant.com>
Date: Wed, 20 Aug 2025 20:23:39 -0400
Subject: [PATCH] Add breaking change note.

Fixes https://github.com/wixtoolset/issues/issues/9142
---
 src/content/docs/wix/whatsnew/index.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/src/content/docs/wix/whatsnew/index.md b/src/content/docs/wix/whatsnew/index.md
index 80a2388..80be0f8 100644
--- a/src/content/docs/wix/whatsnew/index.md
+++ b/src/content/docs/wix/whatsnew/index.md
@@ -85,6 +85,14 @@ WiX v5 addressed one of the custom actions and WiX v6 addresses the other, so no
   ExtendedPathValidation="yes" />
 ```
 
+:::caution[Breaking change for customized dialog sets]
+As part of the effort to remove custom actions from WixUI, the `BrowseDlg` dialog, which lets the user browse for a directory, has its behavior moved out of the `BrowseDlg` dialog itself and into the dialog set. If you create a customized dialog set, you need to do likewise. For example:
+
+```xml
+<Publish Dialog="BrowseDlg" Control="OK" Event="SetTargetPath" Value="[_BrowseProperty]" Order="3" />
+<Publish Dialog="BrowseDlg" Control="OK" Event="EndDialog" Value="Return" Order="4" />
+```
+:::
 
 ### Burn locks extracted payloads