Bot Permissions
Understand what permissions Team Up needs and how to configure command access for your server
Required Permissions
These permissions are essential for the bot to function. Without them, basic commands won't work.
Send Messages
Send match announcements, leaderboard displays, followup responses, and all bot messages.
Embed Links
Display rich embeds for leaderboards, player stats, match results, and other formatted information.
Use Slash Commands
Allow users to interact with the bot using slash commands like /record_match, /leaderboard, etc.
Optional Permissions
These permissions enable specific features. Grant them based on which features you want to use.
Manage Roles
Tier RolesAutomatically assign and remove tier roles based on player ratings. Required for the /tiers feature.
Manage Channels
Temporary Match ChannelsCreate and delete temporary text/voice channels for matches. Required for matchmaking temporary channels.
Connect
Voice ChannelsRequired when creating voice channels for matches. The bot needs this to set up voice channel permissions.
Move Members
Auto-Move to VoiceAutomatically move players into their team voice channels when a match starts.
Create Public Threads
Match ThreadsCreate match discussion threads attached to lobby messages for team communication.
Manage Messages
Lobby CleanupDelete lobby messages when matches are closed or completed.
Read Message History
GeneralAccess previous messages in channels for certain features.
Recommended Setup
For most servers, we recommend granting Send Messages, Embed Links, Use Slash Commands, and Manage Roles. This covers basic functionality plus tier role assignments. Add other permissions as needed for matchmaking features.
Command Access for Members
By default, most Team Up commands are restricted to server administrators only. This gives you full control over who can use each command. Use Discord's built-in Integrations settings to grant command access to specific roles or channels.
Default Permissions
Only server administrators can use commands like /record_match, /leaderboard, /queue_versus, etc. by default. You'll need to configure permissions in Discord's Integrations settings to allow other members to use these commands.
How to Grant Command Permissions
Open Server Settings (click your server name at the top)
Navigate to Integrations in the left sidebar
Find Team Up in the list and click Manage
Click on any command to add role or member overrides to grant access
Important: Desktop Only
Command permission configuration can only be done on the Discord desktop app. This feature is not available on mobile devices.
Grant by Role
Give specific roles access to certain commands. Common setup example:
- Admins: All commands (default)
- Moderators: /record_match, /set_rating
- @everyone: /leaderboard, /stats, /profile
Grant by Channel
Control where commands can be used. Keep bot interactions organized:
- #bot-commands: Member commands
- #matchmaking: Queue commands
- #admin-only: Admin commands
Role Hierarchy for Tiers
When using tier roles, the bot's role must be positioned above all tier roles in Discord's role hierarchy. Otherwise, the bot won't be able to assign or remove those roles.
Setting Up Role Hierarchy
Open Server Settings → Roles
Find the Team Up role (created when you added the bot)
Drag the Team Up role above all your tier roles (Bronze, Silver, Gold, etc.)
Example Role Order
Troubleshooting Tier Roles
If tier roles aren't being assigned after matches:
- Check that the bot role is above the tier roles in the hierarchy
- Verify the bot has the Manage Roles permission
- Ensure tiers are configured with
/tiers create