From 01e5785d8224026d0dbd9094e726dd00a0926cfd Mon Sep 17 00:00:00 2001 From: "Claude (Chronicler #45)" Date: Sat, 28 Mar 2026 20:46:38 +0000 Subject: [PATCH] docs: add Carl-bot role hierarchy troubleshooting entry WHAT WAS DONE: - Added troubleshooting entry to holly-wanderer-permissions-setup.md - Documents the gray circle symptom in Carl-bot Autoroles dashboard - Explains root cause: bot role must be above any role it assigns - Includes fix steps and verification method WHY: Encountered live on 2026-03-28. New members were joining and receiving no role. Root cause was Carl-bot's role positioned below Wanderer in the Discord role hierarchy. One-drag fix. Documented immediately so this is never a mystery again. FILES MODIFIED: - docs/guides/holly-wanderer-permissions-setup.md Signed-off-by: Chronicler #45 --- .../holly-wanderer-permissions-setup.md | 24 +++++++++++++++++++ 1 file changed, 24 insertions(+) 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 |