Gildi’s permissions and role order
Why Gildi can’t give a role or moderate someone, how to move its role higher, what the Health check flags, and the fix for each error message.
Gildi can only give, take or moderate below its own highest role. That’s Discord’s rule, not Gildi’s. So two things have to be true: Gildi has Manage Roles, and its role sits above every role it hands out and every member it moderates.
Move Gildi’s role higher
- Open Server Settings, then Roles.
- Find Gildi’s role. It has Gildi’s name and was made when Gildi joined.
- Drag it above the roles Gildi gives out: auto-roles, level rewards, role menu roles, a quarantine role and so on.
- Save.
For moderation, Gildi’s role must also be above the highest role of anyone it kicks, bans or times out. Nobody can moderate the server owner, Gildi included.
The Health check
The dashboard’s Overview page checks your server and lists what stops your modules from working:
- Gildi is missing a permission that a module you switched on needs. The Re-invite Gildi button asks Discord for all of them again.
- A role is above Gildi’s role, so Gildi can’t give or take it. Move Gildi’s role higher, as above.
- Gildi can’t post in a channel a module sends to. Fix permission lets Gildi view, post, embed, attach and read history in that one channel.
- A module points at a channel that’s gone. Pick a new one on that module’s page.
- Gildi is offline, because Discord rejected its token.
Only modules that are on are checked, so a module you don’t use never raises a warning.
What each module needs
These are the permissions the Health check looks for. Modules not listed here only need to read and send messages.
| Module | Needs |
|---|---|
| Welcome & Goodbye | View Channels, Send Messages, Embed Links, Attach Files, Manage Roles, Manage Server |
| Moderation | Ban Members, Kick Members, Timeout Members, Manage Messages, Manage Channels, Manage Nicknames, Manage Roles |
| Appeals | Ban Members, Timeout Members, Create Invite, Send Messages, View Channels, View Audit Log |
| Anti-raid | Manage Server, Manage Roles, Manage Channels, Kick Members, Ban Members |
| Audit logs | View Audit Log, Send Messages, Embed Links |
| Timed messages | Send Messages, Embed Links, Manage Messages |
| Levels & leaderboards | Manage Roles, Attach Files |
| Economy | Manage Roles |
| Role menus | View Channels, Send Messages, Manage Roles, Manage Messages |
| Verification | View Channels, Send Messages, Manage Roles, Manage Channels, Kick Members |
| Invite tracking | Manage Server, Manage Roles |
| Temporary voice | Manage Channels, Manage Roles, Move Members |
| Sticky messages | Send Messages, Manage Messages |
| Tickets | View Channels, Send Messages, Create Private Threads, Manage Threads, Manage Channels |
| Forms & applications | Send Messages, Manage Roles |
| Giveaways, Starboard | Send Messages, Embed Links |
| Suggestions | Send Messages, Manage Channels, Manage Threads |
| Birthdays | Send Messages, Manage Roles |
| Stats channels | Manage Channels |
So Manage Roles matters for Welcome & Goodbye, Moderation, Anti-raid, Levels, Economy, Role menus, Verification, Invite tracking, Temporary voice, Forms and Birthdays.
Error messages and how to fix them
| You see | Why | Fix |
|---|---|---|
| Gildi’s role has to be above theirs. Move it up in Server Settings, under Roles. | The member’s highest role is at or above Gildi’s. | Drag Gildi’s role above theirs. |
| Discord doesn’t let anyone moderate the server owner. | The target owns the server. | Nothing to fix: the owner can’t be kicked, banned or timed out. |
| You can’t moderate the server owner. | A moderator ran a command on the owner. | As above. |
| You can’t moderate someone with an equal or higher role. | The moderator’s highest role isn’t above the target’s. | Someone with a higher role has to do it. |
| Gildi’s highest role must be above @role, and Gildi needs Manage Roles. | A flow or module tried to give or take a role Gildi can’t reach. | Move Gildi’s role above @role, and check it has Manage Roles. |
| @role is at or above your highest role, so only someone above it can pick it here. | In the dashboard, you picked a role for Gildi to hand out that’s above your own. | Ask someone with a higher role to pick it. |
| @role can manage roles or the server, so only an Administrator can pick it here. | The role carries Administrator, Manage Server or Manage Roles. | An Administrator has to pick it. |
The last two keep anyone with dashboard access from using Gildi to hand out more power than they have themselves. Administrators can pick any role.
Questions
Why can’t Gildi give a role?
Gildi needs Manage Roles, and its own highest role must sit above the role it gives. Open Server Settings, Roles, and drag Gildi’s role above it.
Why can’t Gildi ban or time out a member?
Discord doesn’t let a bot act on the server owner, or on anyone whose highest role is at or above the bot’s. Move Gildi’s role up in Server Settings, Roles.
Where do I see what Gildi is missing?
On the Overview page of the dashboard. It lists missing permissions, roles above Gildi’s and channels Gildi can’t post in, with a fix where Gildi can make one.