Permission List
Role Hierarchy refers to the order of roles. A user's position is based on their highest role, except for the server owner, who is always at the very top of the hierarchy.
Note that it is based on the highest role in general, not the highest role with the specified permission. Therefore, a mod with a cosmetic role that is higher than the mod role can ban mods without that role, even if the cosmetic role carries no permissions.
link
Create Invite (CREATE_INSTANT_INVITE
)
Text, Voice, Stage
Allows users to create invite links to the server, which other users can use to join the server. Users do not need this permission to share existing invite links, including the vanity URL, only to create new invites.
This does not allow users to add bots - that requires Manage Guild.
link
Kick Members (KICK_MEMBERS
)
Server-Wide
Allows users to kick members from the server, instantly removing them from the server but not preventing them from rejoining. This is subject to role hierarchy.
link
Ban Members (BAN_MEMBERS
)
Server-Wide
Allows users to ban members from the server, preventing them from rejoining the server and also banning their IP.
Allows users to unban members, allow them to rejoin the server (if they have an invite; unbanning does not re-add members).
Bans are permanent unless revoked. Users who aren't in the server can be banned to prevent them from joining. This is subject to role hierarchy, and non-members are considered underneath everyone.
link
Administrator (ADMINISTRATOR
)
Server-Wide
Grants users all permissions in the server and in all channels. Also prevents users from being timed out by anyone. This is still subject to role hierarchy, so admins cannot kick/ban anyone not below them and can be kicked/banned by anyone above them.
This is a dangerous permission to grant! Administrators gain permission to do anything - all permissions, as well as access to all channels. They are not immune to moderation except for timeouts, but deny overrides will have no effect on them.
link
Manage Channels (MANAGE_CHANNELS
)
Text, Voice, Stage
Allows users to create, edit, and delete channels. Editing channels includes changing the channel's name, topic, bitrate, video quality, user limit, region, slowmode, auto-archive duration for threads, etc.
This permission does not allow users to edit channel overrides; that is part of Manage Roles.
link
Manage Server (MANAGE_GUILD
)
Server-Wide
Allows users to edit server properties such as the name, icon, banner, etc. Also allows users to add applications to the server (e.g. bots). Also allows users to configure built-in AutoMod and users with this permission always bypass AutoMod.
This does not allow users to delete the server, change the 2FA requirement for moderation, or apply for Discord partnership. Those are only available to the server owner.
link
Add Reactions (ADD_REACTIONS
)
Text, Voice
Allows users to add new emoji reactions to messages.
This permission is not needed to add to an existing reaction, e.g. in the case of reaction role prompts. Users who are timed out or have not passed membership screening cannot do this.
Users can always remove their own reactions.
link
View Audit Log (VIEW_AUDIT_LOG
)
Server-Wide
Allows users to see the audit log which keeps track of moderation and administrative actions for a certain amount of time. They can see all actions, even those that they do not have permission to perform.
link
Use Priority Speaker (PRIORITY_SPEAKER
)
Voice
Allows users to enable Push-To-Talk Priority Speaker mode, which causes all other users in a voice channel to have their volume reduces while the user is using priority mode.
link
Stream (STREAM
)
Voice
Allows users to stream in a voice channel, including screensharing and using the video camera.
link
View Channel (VIEW_CHANNEL
)
Text, Voice, Stage
Allows users to see channels and see incoming messages while focused on the channel. Users can see category channels if they can see at least one channel in it, and seeing a category does not automatically allow them to see any or all channels in it.
The ability to see messages that were sent when the user was offline or the channel was unfocused is controlled by Read Message History.
link
Send Messages (SEND_MESSAGES
)
Text, Voice
Allows users to send messages in text and text-in-voice channels that they can view. Also allows users to create forum posts but not to talk in them.
To talk in threads and forum posts, users need Send Messages In Threads instead.
link
Send Text-To-Speech Messages (SEND_TTS_MESSAGES
)
Text, Voice
Allows users to use /tts
which sends a message that is read aloud to
everyone focused on the channel.
link
Manage Messages (MANAGE_MESSAGES
)
Text, Voice
Allows users to delete other users' messages, pin messages, publish other users' messages in announcement channels, and remove embeds from other users' messages. Except for pinning messages, the other three are always available for one's own messages. This is not subject to role hierarchy.
link
Embed Links (EMBED_LINKS
)
Text, Voice
Links that users send will show embeds if possible and the user has not
suppressed embeds using <...>
. For bots, this is necessary
for them to send custom embeds in messages.
link
Attach Files (ATTACH_FILES
)
Text, Voice
Allows users to upload files in messages they send. This is not limited to images; users can upload most types of files.
link
Read Message History (READ_MESSAGE_HISTORY
)
Text, Voice
Allows users to view messages in channels that they can view, even if they were not focused on the channel at the time, and allows them to search back through all past messages.
Without this permission, users will see "You do not have permission to view the history of this channel." and will only be able to see messages received by their client while they were in that channel.
link
Mention @everyone
@here
and All Roles (MENTION_EVERYONE
)
Text, Voice, Stage
Allows users to use @everyone
to ping all server members who can
see the channel, @here
to ping all online members who can see the
channel, and ping any role regardless of if it has the "Allow anyone to
@mention
this role" setting enabled. This is not subject to role hierarchy.
In stage channels, this allows users to alert @everyone
when starting
an instance.
link
Use External Emojis (USE_EXTERNAL_EMOJIS
)
Text, Voice
Allows users to use emojis from other servers in messages and reactions (if they have Nitro or are a bot).
link
View Server Insights (VIEW_GUILD_INSIGHTS
)
Server-Wide
Allows users to see the server insights page, which provides information about server health, members joining and leaving, which invites they are using, member retention, participant message count, etc.
link
Connect (CONNECT
)
Voice, Stage
Allows users to join voice and stage channels that they can see. Being able to speak is controlled by Speak but they can listen unless deafened.
link
Speak (SPEAK
)
Voice
Allows users to speak in voice channels that they are connected to. This does not allow users to speak in stage channels; stage moderators are appointed separately per stage channel (via the channel permission settings) and choose who is allowed to speak.
link
Mute Members (MUTE_MEMBERS
)
Voice, Stage
Allows users to force-mute users (including themselves), preventing them from speaking in any channel regardless of if they have the Speak permission. Also allows users to undo force-mutes, including on themselves. Users who have muted themselves cannot be muted by anyone else. This is not subject to role hierarchy.
link
Deafen Members (DEAFEN_MEMBERS
)
Voice, Stage
Allows users to force-deafen users (including themselves), preventing them from hearing what is happening in voice or stage channels. Also allows users to undo force-deafens, including on themselves. Users who have deafened themselves cannot be undeafened by anyone else. This is not subject to role hierarchy.
Unlike how self-deafening works, a user can be force-deafened but still allowed to speak. This can be used to disable music bots' ability to hear, which is useful if you are concerned about spying.
link
Move Members (MOVE_MEMBERS
)
Voice, Stage
Allows users to move members who are already in a voice channel in this server into another voice channel. The user performing this action must have Connect in the target channel, but the target user does not need to be able to see or join it on their own. Users cannot be connected by another user and can never be moved between servers even if the user has this permission in both servers. This is not subject to role hierarchy.
link
Use Voice Activity (USE_VAD
)
Voice
Allows users to use voice activity detection mode. Without this permission, users can only use Push-To-Talk.
link
Change Nickname (CHANGE_NICKNAME
)
Server-Wide
Allows users to change their own nickname.
link
Manage Nicknames (MANAGE_NICKNAMES
)
Server-Wide
Allows users to change other members' nicknames. This is subject to role hierarchy.
link
Manage Roles (MANAGE_ROLES
)
Text, Voice, Stage
Allows users to create, edit, delete, add, and remove roles that are below them in role hierarchy (however, adding/removing roles can be done to members above them in hierarchy).
Allows users to edit channel overrides for roles that are below them and permissions that they have.
link
Manage Webhooks (MANAGE_WEBHOOKS
)
Text, Voice
Allows users to create, edit, and delete webhooks, as well as view a list of webhooks and get their URLs.
link
Manage Emojis and Stickers (MANAGE_EMOJIS_AND_STICKERS
)
Server-Wide
Allows users to upload, rename, and delete emojis and stickers. Also allows bots to control which roles can use emojis, which is a little-known feature that isn't very useful and isn't supported by most bots.
link
Use Application Commands (USE_APPLICATION_COMMANDS
)
Text, Voice
Allows users to use slash commands and context menu commands (right clicking a message or user and selecting "Apps").
This permission is not needed for the bot to support application commands;
that is the application.commands
scope set when inviting the bot.
If you are not seeing a bot's commands and you gave it this scope, you likely
have too many bots; if you have over 50 bots, some will no longer be able to
register commands.
In fact, this permission currently does nothing for bots.
link
Request To Speak (REQUEST_TO_SPEAK
)
Stage
Allows users to request to become a speaker in stage channels, which can be approved or denied by stage moderators.
link
Manage Events (MANAGE_EVENTS
)
Voice, Stage
Allows users to create, edit, and delete server events, including starting and ending them.
link
Manage Threads (MANAGE_THREADS
)
Text
Allows users to edit, archive, unarchive, lock, unlock, and delete threads and view all private threads.
link
Create Public Threads (CREATE_PUBLIC_THREADS
)
Text
Allows users to create public threads (threads that all users can see).
link
Create Private Threads (CREATE_PRIVATE_THREADS
)
Text
Allows users to create private threads, which can only be seen by users with Manage Threads and users who are explicitly invited to the thread.
link
Use External Stickers (USE_EXTERNAL_STICKERS
)
Text, Voice
Allows users to send messages with stickers from other servers.
link
Send Messages in Threads (SEND_MESSAGES_IN_THREADS
)
Text
Allows users to send messages in threads and forum posts.
To create forum posts and talk in text and text-in-voice channels, users need Send Messages.
link
Use Activities (USE_EMBEDDED_ACTIVITIES
)
Voice
Allows users to use activities such as YouTube's Watch Together in voice channels.
link
Timeout Members (MODERATE_MEMBERS
)
Server-Wide
Allows users to timeout other members, disabling all permissions except View Channel and Read Message History. Some other features like adding to existing reactions or using message components (buttons and dropdowns) are also disabled.
Administrators cannot be timed out. If a user is timed out and gains the permission, their timeout will be canceled. Even if an administrator could be timed out, it would take no effect.