Skip to main content
GETTING STARTEDSecurity5 min read

Permissions Matrix & Role Hierarchy

Understand Discord's role hierarchy and configure permissions for bulletproof moderation.

Prerequisites & Permissions
  • Server Owner or Administrator status.

Architecture & Overview

Discord enforces a strict mathematical role hierarchy: a bot or user cannot manage, kick, ban, timeout, or assign roles to any user whose highest role is equal to or higher than their own highest role.

To allow WilBot to protect your server, its integration role must be positioned strategically near the top of your role hierarchy list.

Key Features & Capabilities

Hierarchy Protection
Prevents unauthorized role modification above the bot's authorization ceiling.
Granular Override Support
Configurable per-category and per-channel without server-wide privileges.
Audit Verification
Validates executor identity before logging sensitive staff actions.

Step-by-Step Walkthrough

1

Open Server Role Settings

In Discord, navigate to Server Settings > Roles.

2

Position WilBot's Role in Hierarchy

Drag WilBot's role (usually titled 'WilBot') above all moderator, member, and progression roles. Keep it below Server Owner / Head Admin roles for safety.

TIP:WilBot cannot timeout or assign roles to members whose roles sit above WilBot in this list.
3

Enable 'View Audit Log' Permission

Ensure WilBot's role has the 'View Audit Log' permission turned ON. This is required for the nickname audit engine and anti-raid offender identification.

Real-World Examples & Outputs

Role Hierarchy Diagram

Optimal Discord Server Role Order
👑 Server Owner 🛡️ Head Admin 🤖 WilBot (Integration Role) <--- Place Here 👮 Senior Moderators ⚡ Level 50+ VIPs 👤 Members (@everyone)

Troubleshooting & Common Pitfalls

Issue:WilBot returns 'DiscordAPIError: Missing Permissions' when attempting to timeout a member.
Resolution: Check the member's roles. If they have ANY role that is placed above WilBot's highest role, Discord blocks the action. Move WilBot's role higher.

Frequently Asked Questions

Why can't WilBot moderate the server owner?

Discord fundamentally forbids any bot or user from moderating the server owner regardless of role hierarchy.

Related Documentation & Guides

Still have questions?
Our team is available 24/7 on Discord to help you configure WilBot for your server.