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

  1. Open Server Settings, then Roles.
  2. Find Gildi’s role. It has Gildi’s name and was made when Gildi joined.
  3. Drag it above the roles Gildi gives out: auto-roles, level rewards, role menu roles, a quarantine role and so on.
  4. 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.