diff --git a/docs/swarm/ui.md b/docs/swarm/ui.md
index d2c7be61..14364b3e 100644
--- a/docs/swarm/ui.md
+++ b/docs/swarm/ui.md
@@ -433,8 +433,9 @@ routes take. The controller checks them with the `PUT` rules before it queues
 anything, so a bad value gets a refusal with its reason and creates no agent.
 
 The dialog loads the hive list and the permission list when it opens. If either
-load fails, the dialog says why in place of an empty picker, with the text
-`could not load hives` or `could not load permissions`.
+load fails, the dialog shows the reason in an error panel above the fields, and
+the hive picker or the permissions area reads `could not load hives` or
+`could not load permissions` in place of `loading…`.
 
 It stores them ahead of the job graph, before it declares the agent, so they
 are in place before the agent first runs. If the creation then fails, the