Troubleshooting: common errors and fixes
The error messages Gildi shows most often, what each one means and how to fix it, plus what to check when a command, welcome card or role doesn’t work.
Most problems come down to three things: Gildi’s role is too low, Gildi can’t see or post in a channel, or a module is switched off. The dashboard’s Overview page checks your server for the first two and lists anything it finds.
Error messages
| You see | What it means | How to fix it |
|---|---|---|
| Gildi’s role has to be above theirs. Move it up in Server Settings, under Roles. | A moderation step tried to act on someone whose highest role is level with or above Gildi’s. | In Discord, open Server Settings, Roles and drag Gildi’s role above theirs. See Permissions and roles. |
| @Role is above Gildi’s role | A module gives out a role that sits above Gildi’s highest role, so Gildi can’t give or take it. | Move Gildi’s role higher in Server Settings, Roles. |
| Gildi needs the … permission for this, or its role is too low. | Discord refused a step because Gildi is missing a permission. | Give Gildi’s role that permission, in the server or in that channel, or move its role up. |
| Gildi is missing … | The Overview page found permissions your modules need. | Use the fix button there: re-inviting Gildi asks Discord for all of them. |
| Gildi can’t post in #channel | A module sends messages to a channel where Gildi can’t see it or can’t send. | Give Gildi View Channel and Send Messages in that channel. |
| This server has used its flow runs for this month. An admin can see more on the Gildi dashboard. | The server went past its monthly flow runs. | Wait for the 1st of the month or upgrade. See Flow runs. |
| This flow is running too often. Try again in a minute. | One flow started too many times in a minute, usually because flows are starting each other. | Wait a minute. If it keeps happening, check your flows for one that sets off another. See Rate limits. |
| Only someone with Manage Server can do this. | Billing, dashboard access, the custom bot and removing Gildi need Manage Server. A dashboard role isn’t enough. | Ask someone with Manage Server, like the owner. |
| Discord allows 100 slash commands per server. | Your flows and modules together would have more than 100 commands. | Turn off a module or unpublish a command you don’t use. |
| MEE6 doesn’t show a public leaderboard for this server. Make it public in MEE6 first. | Gildi reads MEE6’s public leaderboard to import levels, and yours is private. | Make the leaderboard public in MEE6, then import again. See Import MEE6 levels. |
| Turn on the Server Members and Message Content intents first. | Your own bot doesn’t have the two settings Gildi needs. | In the Discord Developer Portal, open your bot’s Bot tab and switch on both. See Custom bot setup. |
| Switch back to Gildi first, then paste the new bot. | You’re replacing a custom bot while the old one is still running your server. | Switch the server back to Gildi on the Custom bot page, then add the new bot. |
| This command is not set up any more. | The flow behind the command was removed or switched off, but Discord still showed it. | Restart Discord to refresh its command list, or publish the flow again. |
| This isn’t set up in this server any more. | A button or command belongs to a module that’s now switched off. | Switch the module back on, or remove the old message. |
| You can’t moderate someone with an equal or higher role. | The moderator’s own highest role isn’t above the member’s. | Have someone with a higher role do it. |
My command doesn’t show up
- Is the module or flow on? A module’s commands only exist while the module is switched on, and a flow’s command only once it’s published. See Turning modules on.
- Give Discord a moment. Discord takes 2 command updates every 30 seconds, so after several changes the last ones can take a little while. Then restart Discord, or press Ctrl+R on desktop, to refresh its command list.
- Are you over 100? Discord allows 100 slash commands per server, including the ones from modules.
- Can you use it? Commands meant for moderators are hidden from members without the permission they need.
The welcome card isn’t sending
Gildi needs View Channel, Send Messages, Embed Links and Attach Files in the welcome channel. Channel permissions override server ones, so check the channel’s own settings too. The Overview page flags a welcome channel Gildi can’t post in, and a channel that’s been deleted.
Roles aren’t being given
Discord only lets a bot give roles that are below its own highest role. In Server Settings, Roles, drag Gildi’s role above every role it hands out: welcome roles, level rewards, role menus and shop roles. Gildi also needs Manage Roles. Roles managed by another bot or by Discord, like a booster role, can’t be given by anyone. See Permissions and roles.
Still stuck?
Check the flow’s run history in the dashboard: each step that failed says why. If that doesn’t help, email hello@gildi.gg.