Skip to main content

Discord Role Hierarchy

Discord ranks every role in a server by its position in Server Settings → Roles, and that order decides who can manage which roles. It applies to bots and moderators alike, and it is essential to understand for RoleLogic to work.

Quick answer

To make a role higher, open Server Settings → Roles, drag it up the list, and save. On mobile, tap Reorder first. You can only move roles that sit below your own highest role; the server owner can move any of them.

The Basic Rule​

A bot can only manage roles that are BELOW its own highest role in the server's role list.

Members follow the same rule: a moderator with the Manage Roles permission can only assign, remove, or edit roles below their own highest role. Only the server owner is exempt. This is a Discord security feature, not a RoleLogic limitation.

Example​

Admin ← Cannot manage
Moderator ← Cannot manage
RoleLogic ← Bot's position
VIP ← CAN manage
Member ← CAN manage
Unverified ← CAN manage
@everyone ← CAN manage

Moving a Role Above Another Role​

The role list reads top to bottom: every role outranks the roles below it. To change the order:

On desktop or in a browser

  1. Open Server Settings → Roles
  2. Drag the role up or down the list
  3. Save

On mobile

  1. Open the server menu and tap Settings → Roles
  2. Tap Reorder
  3. Drag the role by its handle, then save

You can only move roles that sit below your own highest role, and only to positions below it. To reorder roles higher than yours, ask the server owner or someone whose highest role is above them. @everyone always stays at the bottom.

For a bot, move the bot's role above the roles it should manage, or move those roles below it. Either way, what counts is the bot's highest role.

Why Can't I Drag a Role?​

  • It's above your highest role. Your highest role is the top-most role you hold. You can't drag anything at or above it, and you can't drop a role above it either. Only someone ranked higher, or the server owner, can change that part of the list.
  • You don't have Manage Roles. Without the Manage Roles permission (or Administrator), the role list is read-only.
  • It's @everyone. It is always the lowest role and never moves.
  • You're on mobile and didn't tap Reorder. The list only becomes draggable in reorder mode.
  • You didn't save. The new order isn't kept until you save the change.

The server owner can move every role, whatever roles they hold.

Is Admin Higher Than Moderator?​

Discord has no built-in Admin or Moderator rank. Whichever role sits higher in the list outranks the other, whatever it is called. Administrator is a permission, not a position: it doesn't move a role up the list (see below).

Setting Up RoleLogic's Position​

  1. In Discord, go to Server Settings → Roles
  2. Find the "RoleLogic" role
  3. Drag it above all roles you want it to manage
  4. Save

Example setup:

Admin
Moderator
RoleLogic ← Position here
VIP
Member
Unverified
@everyone

You don't need RoleLogic at the very top. Just above the roles it needs to manage.

"Above Your Highest Role" Errors​

When a bot says it can't use a role because the role is above my highest role, it has hit Discord's hierarchy rule: the role is not below the bot's own highest role. Moderators run into the same wall when they try to give a member a role that ranks at or above their own. Discord only allows assigning roles below the assigner's highest role, so even that highest role itself can't be given to someone else.

  • For a bot: drag the bot's role above the role it should assign (how to reorder roles). If RoleLogic put a rule on hold because of it, press Resume afterwards.
  • For a moderator: ask the server owner, or someone whose highest role is above that role, to assign it for you or move your role higher.

Moderation follows the same ranking: a bot or member can only kick, ban, or change the nickname of members whose highest role is lower than their own.

Bot Role Error Messages, Decoded​

Every role bot words the hierarchy error differently, but almost all of them come down to the same few causes. Find the message you are seeing:

The message saysWhat it meansFix
Missing Permissions (Discord error 50013)The bot lacks Manage Roles, or the role or member it is acting on ranks at or above the bot's highest role.Grant Manage Roles, then move the bot's role above the target role.
"...above my highest role" / "higher than my highest role"Hierarchy: the role is not below the bot's own highest role.Move the bot's role above it.
"All given roles have to be below me and not managed"Two checks at once: each role must be below the bot's highest role, and must not be managed by an integration.Move the bot's role up. If the role is managed, pick a role your server owns instead.
"Please check if bot's role is above the role you are trying to give"Hierarchy, as above.Move the bot's role above it.
"Cannot manage this role"Hierarchy, or the role is managed by an integration.Move the bot's role up; if that changes nothing, the role is managed.
"This role is automatically managed by an integration"The role belongs to a bot, Server Booster, Linked Roles, or another integration.Nobody can assign it by hand. Use a role your server owns.
Unknown Role (Discord error 10011)The role no longer exists, usually because it was deleted.Select the role again in the bot's settings or rule.
Missing Access (Discord error 50001)The bot can't see the server or channel it is acting in.Check the bot is still in the server and can view the channel.

If none of these match, work through the four causes in order: hierarchy, permission, condition, then something undoing the change.

Administrator Does Not Override Role Position​

The Administrator permission grants every permission and bypasses channel permission overwrites, but it does not change where a role sits in the list. A bot or member with Administrator still can't assign, remove, or edit a role at or above their highest role, or kick or ban a member whose highest role is at or above theirs. Only the server owner ignores role position.

So giving a bot Administrator doesn't fix a hierarchy error; moving its role does. RoleLogic doesn't need Administrator: Manage Roles and the right position are enough for role automation.

Roles Managed by an Integration​

Some roles are controlled by Discord or by an integration rather than by your server's staff. No bot can assign them, however high its own role sits:

  • Bot roles — the role Discord creates for a bot when you invite it, named after the bot. You can move it and edit its permissions, but it belongs to that bot alone and can't be given to anyone else.
  • Server Booster — Discord adds and removes it as members start and stop boosting.
  • Linked Roles — roles with connection requirements. Members claim them themselves once their connected accounts meet the requirements.
  • Other integration roles — roles another integration creates and keeps in sync.

RoleLogic can still read these roles in a condition; only the roles it adds or removes must be manageable. For example, a rule can check Server Booster and add your own VIP role, as in automatic booster role rewards. If an action targets one of these roles, point it at a role your server owns instead.

This is different from RoleLogic's own integrations, which assign an ordinary server role that you pick. Like any other target, that role only needs to sit below RoleLogic.

The Manage Roles Permission​

RoleLogic also needs the "Manage Roles" permission (requested during invite).

To verify:

  1. Go to Server Settings → Roles
  2. Click the RoleLogic role
  3. Check that "Manage Roles" is enabled

What Happens If Hierarchy Is Wrong​

  • The action fails for roles above RoleLogic
  • Other roles in the same action may still work
  • The refused change shows as no permission in the Activity Log's Role changes history
  • If Discord keeps refusing a role, RoleLogic puts every rule that changes it on hold, with the reason in the status bar; move RoleLogic above that role, then press Resume

Common Setups​

VIP System​

Admin
Moderator
RoleLogic
VIP Gold
VIP Silver
VIP Bronze
Member

RoleLogic manages all VIP tiers and Member.

Limited Automation​

Admin
Moderator
VIP
RoleLogic ← Lower position
Member
Unverified

RoleLogic only manages Member and Unverified. Staff and VIP are protected.

Full Automation​

Owner
RoleLogic ← High position
Admin
Moderator
VIP
Member

RoleLogic can manage almost everything (use carefully).

Troubleshooting​

"Cannot manage this role"​

The target role is above RoleLogic. Drag RoleLogic higher in server settings. If the role is managed by an integration, no position fixes it; target a role your server owns instead.

Rules work for some roles but not others​

Check hierarchy for each role. Some may be manageable while others aren't.

Nothing is working​

  1. Confirm "Manage Roles" permission is enabled
  2. Confirm RoleLogic is above target roles
  3. Check rules are enabled
  4. Verify conditions actually match

If the hierarchy checks out and roles still don't change, work through the other causes in order with Fix a Discord bot that is not assigning roles, or use Troubleshoot RoleLogic Rules for rule status, the sandbox, and deployments.

Tips​

  • Keep RoleLogic below Admin/Mod — You rarely need to automate staff roles
  • Plan ahead — Position RoleLogic before creating rules
  • New roles — Remember to check hierarchy when adding new roles