diff --git a/apps/docs/docs/widgets/archive-team-warrior/index.mdx b/apps/docs/docs/widgets/archive-team-warrior/index.mdx
index 594616914..f4b60b918 100644
--- a/apps/docs/docs/widgets/archive-team-warrior/index.mdx
+++ b/apps/docs/docs/widgets/archive-team-warrior/index.mdx
@@ -15,8 +15,8 @@ import { archiveTeamWarriorWidget } from ".";
 <WidgetHeader widget={archiveTeamWarriorWidget} categories={["Archiving", "Monitoring"]} />
 
 Use this widget to see what your ArchiveTeam Warrior is preserving without leaving Homarr. The compact view prioritizes the
-current project and runner state; shorter tiles can hide bandwidth, job counts, or the broadcast message. Advanced view adds
-the complete active-job list and exact update time.
+selected project and Warrior status; shorter tiles can hide secondary counts, bandwidth, or the broadcast message. Advanced
+view adds the runner status, exact update time, and a scrollable list of reported work items.
 
 ### Supported integration
 
diff --git a/apps/docs/docs/widgets/beszel-system-stats/index.mdx b/apps/docs/docs/widgets/beszel-system-stats/index.mdx
index cc44ffc9f..cf0c18fa6 100644
--- a/apps/docs/docs/widgets/beszel-system-stats/index.mdx
+++ b/apps/docs/docs/widgets/beszel-system-stats/index.mdx
@@ -17,7 +17,7 @@ import beszelSystemStats from "./img/beszel-system-stats.png";
 
 <WidgetHeader widget={beszelSystemStatsWidget} categories={["System Monitoring", "Charts"]} />
 
-This widget displays time-series charts for a selected Beszel system, including CPU, memory, disk, network, and Docker container metrics. The Disk Usage chart combines the root disk and every extra filesystem reported by Beszel. Hover over or focus the widget controls to switch between the realtime Live view and historical periods ranging from 1 hour to 30 days. Live view keeps a one-minute window and pauses while the browser tab is hidden. If the live stream drops, the widget now shows the connection failure state immediately and can switch back to historical data.
+This widget displays time-series charts for a selected Beszel system, including CPU, memory, disk, network, and Docker container metrics. The Disk Usage chart combines the root disk and every extra filesystem reported by Beszel. Use the widget controls to switch between the realtime Live view and historical periods ranging from 1 hour to 30 days. Live view keeps a one-minute window and pauses while the browser tab is hidden. If the live stream drops, the widget now shows the connection failure state immediately and can switch back to historical data.
 
 ### Screenshots
 
diff --git a/apps/docs/docs/widgets/immich-album-carousel/index.mdx b/apps/docs/docs/widgets/immich-album-carousel/index.mdx
index f41f34503..ea8f911e1 100644
--- a/apps/docs/docs/widgets/immich-album-carousel/index.mdx
+++ b/apps/docs/docs/widgets/immich-album-carousel/index.mdx
@@ -33,7 +33,7 @@ import screen from "./img/screen.png";
 
 <WidgetInteractionGuide />
 
-Hover or focus the widget to pause its slideshow; touch devices keep the control available. A paused slideshow keeps its resume control visible. The advanced view displays the complete photo without cropping, groups previous, pause or resume, and next together, and includes every loaded photo in its thumbnail strip.
+Use the pause or resume control to pause its slideshow; touch devices keep the control available. A paused slideshow keeps its resume control visible. The advanced view displays the complete photo without cropping, groups previous, pause or resume, and next together, and includes every loaded photo in its thumbnail strip.
 
 ### Adding the widget
 
diff --git a/apps/docs/docs/widgets/weather/index.mdx b/apps/docs/docs/widgets/weather/index.mdx
index f36dc68ea..0ab2e12b4 100644
--- a/apps/docs/docs/widgets/weather/index.mdx
+++ b/apps/docs/docs/widgets/weather/index.mdx
@@ -15,8 +15,9 @@ import { weatherWidget } from ".";
 
 The Weather Widget uses your location to display the current, highest and lowest temperature.
 In the compact view, select a condition icon or forecast day to open details with a mouse, keyboard or touch.
-The advanced view always combines current conditions with the full seven-day forecast, including humidity, wind,
-gusts, sunrise and sunset. Both views reuse the same cached Open Meteo response.
+The compact forecast shows up to the configured number of days. The advanced view combines current conditions with the
+available daily forecast, including humidity, wind, gusts, sunrise and sunset. Both views reuse the same cached Open
+Meteo response.
 
 ### Screenshots
 
diff --git a/apps/docs/src/components/widgets/interactions.tsx b/apps/docs/src/components/widgets/interactions.tsx
index 0e9cb48c0..14fdbf0ee 100644
--- a/apps/docs/src/components/widgets/interactions.tsx
+++ b/apps/docs/src/components/widgets/interactions.tsx
@@ -4,7 +4,7 @@ const advancedInteraction = {
   icon: IconArrowsMaximize,
   title: "Advanced view",
   description:
-    "On supported widgets, hold Shift while hovering for about 500 ms, press Shift + Enter, or choose Open advanced view from the widget menu. It is unavailable in edit mode.",
+    "Supported widgets explicitly opt into advanced view. Focus a widget and press Shift + Enter, hold Shift while hovering for about 500 ms, or choose Open advanced view from its menu. It is unavailable in edit mode and remains compact-only on widgets that do not opt in.",
 } as const;
 
 const standardInteractions = [
@@ -12,19 +12,19 @@ const standardInteractions = [
     icon: IconMouse2,
     title: "Widget actions",
     description:
-      "When signed in, outside edit mode, and with Enable right click on widgets enabled, right-click for live query status, refresh, settings, quick options, and supported actions. App tiles are excluded.",
+      "Signed-in users can open the widget context menu outside edit mode when Enable right click on widgets is enabled. App tiles are excluded. Settings, quick options, and integration actions appear or enable only when the widget and your board or integration permissions allow them.",
   },
   {
     icon: IconLayoutGrid,
     title: "Adaptive detail",
     description:
-      "Resize a widget to tune its density. Compact views keep primary status visible, then reveal details and controls as space or intent allows.",
+      "Resize a widget to tune its density. Compact layouts hide lower-priority details and controls as space shrinks; compact-only widgets adapt in place instead of opening a separate advanced view.",
   },
   {
     icon: IconRefresh,
     title: "Data status",
     description:
-      "Initial loading, successful empty results, terminal errors, stale cached data, and partial integration failures are distinct states. The shared menu reports loading, idle, error, or success with cache age when available; Refresh targets only active queries owned by that widget and view.",
+      "Widgets distinguish initial loading, successful empty results, terminal errors, stale cached data, and partial integration failures as applicable. Initial loads use a loading state, empty results use an empty state, and terminal failures can offer retry; retained data can stay visible with a stale warning, while healthy integrations can remain visible when another source fails. The shared menu reports Loading while matching active queries fetch, Idle when none are active, Error when any match is in error, otherwise Success with the latest data age when available. Refresh refetches only active queries owned by that widget and view and is disabled while they fetch.",
   },
 ] as const;
 
@@ -52,10 +52,12 @@ export const WidgetInteractionGuide = ({ advancedView = true }: { advancedView?:
       {advancedView && (
         <p className="m-0 px-4 pb-4 text-xs text-[#696969] dark:text-[#999]">
           Advanced view reuses existing data where possible; some widgets request additional or denser data. Hold Shift
-          while hovering for a temporary preview, which closes when Shift is released, the pointer leaves, or the window
-          loses focus. The manual view closes with Escape, its close button, or the backdrop; it traps focus and locks
-          background scrolling. Shift + wheel is routed to a scrollable advanced panel when possible. On touch devices,
-          use the widget menu where your browser exposes it; compact-only widgets adapt in place instead.
+          while hovering a supported widget for a temporary preview; it opens after about 500 ms and closes when Shift
+          is released, the pointer leaves, or the window loses focus. For a persistent view, focus the widget and press
+          Shift + Enter or use Open advanced view from its menu. Manual view closes with Escape after nested menus or
+          popovers handle their own Escape, its close button, or the backdrop; it restores focus, traps focus, and locks
+          background scrolling. Shift + wheel scrolls a scrollable advanced panel when it can consume the event. On
+          touch devices, use the widget menu when available; compact-only widgets adapt in place instead.
         </p>
       )}
     </details>