diff --git a/docs/guides/holly-wanderer-permissions-setup.md b/docs/guides/holly-wanderer-permissions-setup.md
index d4087ae..d0b5c41 100644
--- a/docs/guides/holly-wanderer-permissions-setup.md
+++ b/docs/guides/holly-wanderer-permissions-setup.md
@@ -343,6 +343,30 @@ They can participate in Community Hub for free, but they KNOW there's more conte
 
 ---
 
+### **Problem: Carl-bot not assigning Wanderer role to new members (role shows gray in dashboard)**
+
+**Symptoms:**
+- New members join and receive no role at all
+- In Carl-bot dashboard → Autoroles, the Wanderer role tag shows a **gray circle** on the left instead of a colored one
+
+**Root Cause:**
+Discord requires a bot's role to be **higher in the role hierarchy** than any role it tries to assign. If Carl-bot's role sits below Wanderer in the list, Discord silently blocks the assignment.
+
+**Fix:**
+1. Go to **Server Settings → Roles**
+2. Find Carl-bot's role in the list
+3. **Drag it above Wanderer**
+4. Save
+
+**Verification:**
+The Wanderer role tag in Carl-bot's Autoroles dashboard will show a **colored circle** (not gray) once the hierarchy is correct. Test with a fresh join or by removing Wanderer from a test account and rejoining.
+
+**Date Encountered:** March 28, 2026
+**Fixed By:** Michael (Frostystyle)
+**Diagnosed By:** Chronicler #45
+
+---
+
 ## 📊 PERMISSION SUMMARY CHEAT SHEET
 
 | Role | View Channel | Send Messages | Access |