Role Hierarchy Setup

This guide helps users to understand the role setup for role-based rewards

Overview

To allow the Loyalty Admin Portal Bot to assign role-based rewards in your Discord server, the bot must have the correct role hierarchy. If set up incorrectly, the bot cannot assign roles, and users will not receive rewards.

This guide explains:
✅ What is Discord role hierarchy? ✅ How to position the bot’s role correctly?

🔹 What is Discord Role Hierarchy?

In Discord, roles are ranked from top to bottom in the Roles section. A bot can only assign roles that are positioned below its own role.

Example:

  • @Admin (Top)
  • @Bot Role ✅ (Bot must be above roles it assigns)
  • @Rewarded Role ❌ (Cannot assign if above bot role!)

📌 Key Rule:

🛠️ The bot’s role must be above the role it assigns, or it will fail to assign rewards.

🔹 Setting Up the Correct Role Hierarchy

Move the Bot’s Role Higher in Discord

  1. Go to Discord Server Settings → Click Roles.
  2. Find the Bot’s Role (loyalty-bot).
  3. Drag the Bot’s Role Above the Reward Roles.
  4. Save Changes.

🛑 For more details : https://support.discord.com/hc/en-us/articles/214836687-Discord-Roles-and-Permissions