🧭 Discord Permissions Guide

Why a Discord bot can have permission and still fail to moderate someone

Discord permissions answer whether an action is allowed in principle. Role hierarchy answers whether the bot is high enough in the server to perform that action on a particular member. Both conditions must be satisfied.

The two checks Discord makes

When a moderation command such as ban, kick, mute or role management is used, Discord does not only check whether the bot has the relevant permission. Discord also compares role positions. A bot with Administrator can still fail to act on a member whose highest role is equal to or above the bot's highest role.

How to check the hierarchy

  1. Open Server Settings → Roles.
  2. Find the role assigned to Bozos Forever.
  3. Drag the Bozos role above the ordinary member and moderator roles the bot is expected to manage.
  4. Do not place the bot above roles that you intentionally want protected from automated or staff moderation.

Common failure pattern

A server owner gives the bot Administrator and assumes every moderation action must now work. A staff member then tries to mute another moderator whose role is above the bot. Discord rejects the operation because hierarchy still applies. Moving the bot role above the target role fixes that specific problem without changing any command.

Owner and integration limits

The server owner is always special in Discord's hierarchy and cannot be moderated like an ordinary member by a bot. Some managed or integration roles also cannot be moved or modified freely. If an action fails only for one high-ranking member, compare that member's highest role with the bot role before changing permissions.

A safe setup

For Bozos Forever, Administrator is the simplest permission setup because the bot uses several moderation and utility systems. Keep its role high enough to manage the members it should manage, but leave your intentionally protected owner or infrastructure roles above it. This gives the bot enough authority without making the hierarchy confusing.

Quick diagnosis

  • If every moderation command fails, check the bot's permissions first.
  • If commands fail only against certain members, check role hierarchy.
  • If role assignment fails, verify both Manage Roles and the relative position of the target role.
  • If a timeout or mute fails, check whether the target is above the bot or otherwise protected by Discord.
Discord permissions & IDs →Bozos moderation documentation →