Skip to Content
đź“š Welcome to the EventMate documentation - guides, commands, and setup help in one place.
ConfigurationBot Role Position

Position the bot role correctly

EventMate needs the correct role position in your Discord server to use all moderation and role-management features. This guide shows how to place the bot role properly.

Why does role position matter?

Discord uses a role hierarchy. A bot can only manage members whose highest role is below the bot role.

Important features that require the correct role position:

  • Nickname changes during events
  • Role assignment for participants or teams
  • Managing event participants

Check the current position

Open server settings

  1. Open Discord
  2. Right-click your server
  3. Choose “Server Settings”

Go to roles

  1. Click “Roles” in the left sidebar
  2. You will see every role on your server

Find the bot role

  1. Look for the EventMate role
  2. Roles are ordered from top to bottom by priority

Reposition the bot role

Move the role

  1. Stay in the “Roles” section
  2. Find the EventMate bot role
  3. Drag it upward with your mouse
  4. Place it above all normal member roles

The bot role does not need to be above administrator roles, but it must be above every role regular members can have.

Choose a good position

Ideally the bot role should be:

  • Above all regular member roles
  • Above event and team roles
  • Below administrator and moderator roles

Example hierarchy:

1. @Administrator
2. @Moderator
3. @EventMate (bot role) <- good position
4. @VIP
5. @Event-Manager
6. @Member
7. @everyone

Save changes

  1. Click “Save Changes” in the lower-right corner
  2. The new role order is active immediately

Common problems and fixes

The bot cannot change nicknames

Problem: EventMate cannot update certain members.

Fix:

  • Make sure the bot role sits above the target member’s highest role
  • Server owners can never be modified by a bot because of a Discord limitation

The bot cannot assign roles

Problem: EventMate cannot add or remove specific roles.

Fix:

  • The bot role must be above the role it should assign
  • Confirm that the bot has the “Manage Roles” permission

The dashboard shows a warning

Problem: The EventMate dashboard warns about the role position.

Fix:

  • Follow the steps above and move the role
  • Reload the page after the change

Check permissions too

Besides the hierarchy, EventMate also needs:

  • âś… Manage Roles
  • âś… Manage Nicknames
  • âś… Send Messages
  • âś… Embed Links
  • âś… Add Reactions
  • âś… Use Slash Commands

You can review these permissions in Discord under “Server Settings” -> “Integrations” -> “EventMate”.

Need more help?

If problems continue:

  1. Double-check the bot permissions
  2. Remove and re-invite the bot with the correct invite link
  3. Contact support in the Discord support server 

Tip: Most issues around role assignment and nickname changes are fixed by moving the bot role higher.

PermissionsSupport & Feedback