diff --git a/docs/api/base-window.md b/docs/api/base-window.md
index 3982009853..efcd71bbec 100644
--- a/docs/api/base-window.md
+++ b/docs/api/base-window.md
@@ -926,6 +926,17 @@ win.setSheetOffset(toolbarRect.height)
 
 #### `win.flashFrame(flag)`
 
+<!--
+```YAML history
+added:
+  - pr-url: https://github.com/electron/electron/pull/35658
+changes:
+  - pr-url: https://github.com/electron/electron/pull/41391
+    description: Made `window.flashFrame(bool)` flash continuously on macOS.
+    breaking-changes-header: behavior-changed-windowflashframebool-will-flash-dock-icon-continuously-on-macos
+```
+-->
+
 * `flag` boolean
 
 Starts or stops flashing the window to attract user's attention.