diff --git a/docs/src/content/docs/features/windows/options.mdx b/docs/src/content/docs/features/windows/options.mdx
index 9b38d5e2b..62b100567 100644
--- a/docs/src/content/docs/features/windows/options.mdx
+++ b/docs/src/content/docs/features/windows/options.mdx
@@ -828,8 +828,9 @@ Controls how the window behaves across macOS Spaces and fullscreen. These are bi
 - `MacWindowCollectionBehaviorFullScreenAllowsTiling` - Allows side-by-side tiling (macOS 10.11+)
 - `MacWindowCollectionBehaviorFullScreenDisallowsTiling` - Prevents tiling (macOS 10.11+)
 
-**Example - Spotlight-like window:**
+**Note:** NSWindow fullscreen overlay requires application.Options{ Mac: application.MacOptions{ ActivationPolicy: application.ActivationPolicyAccessory } }
 
+**Example - Spotlight-like window:**
 ```go
 // Window that appears on all Spaces AND can overlay fullscreen apps
 Mac: application.MacWindow{
@@ -848,6 +849,32 @@ Mac: application.MacWindow{
 },
 ```
 
+**WindowClass** (`MacWindowClass`)
+- `NSWindow` - Standard window (default)
+- `NSPanel` - Auxiliary window that can float above other windows and receive input without activating the application
+
+**PanelOptions** (`MacPanelOptions`)
+
+Options for NSPanel windows (only applies when `WindowClass` is `NSPanel`):
+- `FloatingPanel` - Panel floats above other windows
+- `BecomesKeyOnlyIfNeeded` - Panel becomes key only when needed
+- `NonactivatingPanel` - Panel receives input without activating the application
+- `UtilityWindow` - Panel uses utility window style
+
+**Note:** Unlike NSWindow, NSPanel fullscreen overlay does NOT require application.Options{ Mac: application.MacOptions{ ActivationPolicy: application.ActivationPolicyAccessory } }
+
+**Example - Spotlight-like panel:**
+```go
+Mac: application.MacWindow{
+    WindowClass: application.NSPanel,
+    PanelOptions: application.MacPanelOptions{
+        NonactivatingPanel: true,
+    },
+    CollectionBehavior: application.MacWindowCollectionBehaviorCanJoinAllSpaces |
+                        application.MacWindowCollectionBehaviorFullScreenAuxiliary,
+},
+```
+
 ### Windows Options
 
 ```go