diff --git a/docs/4-implementation/web-ui/swarm-ui.md b/docs/4-implementation/web-ui/swarm-ui.md
index 13bbfdfbe..f47b29819 100644
--- a/docs/4-implementation/web-ui/swarm-ui.md
+++ b/docs/4-implementation/web-ui/swarm-ui.md
@@ -830,6 +830,9 @@ order with **next** and can step back through with **back** or the step tabs:
 
 1. **identity**: the name, the hive, and optionally an
    [archetype](../../2-handbook/swarm/archetypes.md) that fills in the settings of the steps after it.
+   The archetypes are tiles with their icon and name, laid out like the agent
+   tiles on the broadcast page, with **none** first; an archetype with no icon
+   shows the dimmed hyperhive mark.
    **next** waits for a valid name (1-63 lowercase letters, digits and hyphens)
    and a hive.
 2. **instructions**: the text the agent's `AGENTS.md` starts with, in a box