diff --git a/docs/2-handbook/swarm/ui.md b/docs/2-handbook/swarm/ui.md
index 96bf26d1..b3e78e7a 100644
--- a/docs/2-handbook/swarm/ui.md
+++ b/docs/2-handbook/swarm/ui.md
@@ -40,6 +40,8 @@ request while the last one is still running, so an older answer never overtakes
 a slow one, and a failed refresh keeps the rows already on screen under an
 error. While a page is fetching, its refresh picker shows a spinner in place of
 the clock, for at least 0.4 seconds so a quick answer still reads as a refresh.
+On a folded card (jobs, builds, hives) the picker sits in the card's header, left of the
+chevron, and shows once the card is open; selecting it doesn't fold the card.
 The Jobs page has none yet.
 
 The pages that only display (agents, alerts, builds, review runs and the hives