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 at the very top of the hierarchy strictly above everyone else.
Note that this is based on the highest role overall and not the highest role with the specified position. Therefore, a mod with a cosmetic role that is higher than the mod role will be able to ban mods without the cosmetic role, even if the role carries no permissions.
link Create Invite (CREATE_INSTANT_INVITE
)
Allows the user to create invite links to the server which can be used by other users to join the server. Users do not need this permission to share existing invite links, including the vanity URL, only to create new invites.
Looking for the permission to add bots? See Manage Guild.
link Kick Members (KICK_MEMBERS
)
Allows the user to kick members from the server, removing them instantly but not preventing them from rejoining.
link Ban Users (BAN_MEMBERS
)
Allows the user to ban members from the server, removing them instantly and preventing them from rejoining, and unban members from the server, allowing them to rejoin the server with an invite.
Bans are permanent unless revoked and ban the user and their IP. Users not in the server can be banned to prevent them from joining.
link Administrator (ADMINISTRATOR
)
Grants the user all permissions in the server and all channels. Prevents the user from being timed out. Actions such as banning are still subject to role hierarchy and therefore cannot ban and can be banned by moderators with a higher role, even if the moderator has fewer permissions.
This is a dangerous permission to grant. Administrators gain all permissions which cannot be overridden. They can still be kicked or banned but cannot be timed out and negative overrides will have no effect on them.
link Manage Channels (MANAGE_CHANNELS
)
Allows the user to create, edit, and delete channels. If set per-channel, only allows editing and deleting the specified channel or creating channels if the specified channel is a category channel.
This permission does not allow the user to edit channel overrides — that is controlled by Manage Roles. Creating threads is controlled by Create Public Threads and Create Private Threads and editing and deleting threads are controlled by Manage Threads.
link Manage Server (MANAGE_GUILD
)
Allows the user to edit server properties such as the name, icon, banner, etc., add applications (e.g. bots) to the server, and configure AutoMod. The user always bypasses AutoMod.
Deleting the server, changing the 2FA requirement for moderation, and applying for Discord partnership may only be done by the server owner.
link Add Reactions (ADD_REACTIONS
)
Allows the user to add new emoji reactions to messages.
This permission is not needed to add the an existing reaction. All users who have passed membership screening and are not timed out may do this. Users can also always remove their own reactions.
link View Audit Log (VIEW_AUDIT_LOG
)
Allows the user to see the audit log which keeps track of moderation and administrative actions. They can see all actions, even those which they do not have permission to perform.
link Use Priority Speaker (PRIORITY_SPEAKER
)
Allows the user to enable Push-To-Talk Priority Speaker mode, which reduces the volume of all other users in the same voice channel while being used.
link Stream (STREAM
)
Allows the user to stream video (screen-share or their video camera) in a voice channel.
link View Channel (VIEW_CHANNEL
)
Allows the user to see channels and incoming messages while focused on the channel. Users can see category channels if they can see at least one channel in it, even if they cannot see the category, and can be blocked from viewing channels in categories that they can see.
To see messages that were sent while the user was not focused on the channel, the user must have Read Message History.
link Send Messages (SEND_MESSAGES
)
Allows the user to send messages in text and text-in-voice channels. In forum channels, allows the user to create forum posts.
To send messages in threads and forum posts, the user needs Send Messages In Threads.
link Send Text-To-Speech Messages (SEND_TTS_MESSAGES
)
Allows the user to using /tts
which sends a message that is read aloud to everyone focused on the channel.
link Manage Messages (MANAGE_MESSAGES
)
Allows the user to delete other users' messages, pin messages, publish other users' messages from announcement channels, and remove embeds from other users' messages. Except for pinning messages, the other three are always available for the user's own messages.
This permission is not subject to role hierarchy. You can delete, pin, publish, or remove embeds from anyone's messages with this permission.
link Embed Links (EMBED_LINKS
)
Links that the user sends 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
)
Allows the user 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
)
Allows the user to view messages sent while they were not focused on a channel and allows them to search through 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 while they were focused on the channel.
link Mention @everyone
, @here
, and All Roles (MENTION_EVERYONE
)
Allows users to use
to ping all server members who can see the channel, to ping all online members who can see the channell, and ping any role regardless of if it has the "Allow anyone to @mention this role" toggle enabled. This permission is not subject to role hierarchy.In stage channels, this allows users to alert
when starting a stage instance. link Use External Emoji (USE_EXTERNAL_EMOJIS
)
Allows the user to use emoji from other servers in messages and message or voice reactions (if the have Nitro or are a bot).
link View Server Insights (VIEW_GUILD_INSIGHTS
)
Allows the user to see the server insights page, which provides information about server metrics, members joining and leaving, which invites are being used, member retention, participat message count, etc.
link Connect (CONNECT
)
Allows the user to join voice and stage channels. Permission to speak is controlled by Speak but the user can listen unless server deafened.
link Speak (SPEAK
)
Allows the user to speak in voice channels. This does not allow the user to speak in stage channels — stage moderators are appointed separately per stage channel (via channel permission settings) and choose who is allowed to speak.
link Mute Members (MUTE_MEMBERS
)
Allows the user to server mute users (including themselves), preventing them from speaking in any channel regardless of their permissions. Allows the user to server unmute users (including themselves). Users who are self-muted will not be unmuted by a server unmute. This permission is not subject to role hierarchy.
link Deafen Members (DEAFEN_MEMBERS
)
Allows the user to server deafen users (including themselves), preventing them frmo hearing the contents of voice and stage channels. Allows the user to server undeafen users (including themselves). Users who are self-deafened will not be undeafened by a server undeafen. This permission is not subject to role hierarchy.
Unlike self-deafening, a user is not necessarily implicitly muted when they are server deafened.
link Move Members (MOVE_MEMBERS
)
Allows the user to move members who are in a voice channel into another voice channel in the same server. The acting user must have permission to Connect in the target channel but the target user does not need permissions. Users cannot be moved between servers. This permission is not subject to role hierarchy.
link Use Voice Activity (USE_VAD
)
Allows the user to use voice activity detection mode. Without this permission, users can only use Push-To-Talk.
link Change Nickname (CHANGE_NICKNAME
)
Allows the user to change their own nickname.
link Manage Nicknames (MANAGE_NICKNAMES
)
Allows the user to change other members' nicknames.
link Manage Roles (MANAGE_ROLES
)
If applied server-wide, allows the user to create, edit, delete, add, and remove roles below them in the role hierarchy. The user may add and remove roles from users above them and themselves but can only manipulate roles below them.
Allows the user to edit channel overrides for permissions that they have, but this is not subject to role hierarchy.
link Manage Webhooks (MANAGE_WEBHOOKS
)
Allows the user to create, edit, and delete webhooks and view a list of webhooks and copy their URLs.
link Manage Expressions (MANAGE_GUILD_EXPRESSIONS
)
Allows the user to upload, rename, and delete emoji, stickers, and soundboard sounds. Also allows the bot to control which roles can use emoji.
Discord has built-in support for restricting which roles can use certain emoji. This feature is not well-known and you cannot control it from within the client, but Daedalus offers support for it.
link Use Application Commands (USE_APPLICATION_COMMANDS
)
Allows the user to use slash commands and context menu commands (right-clicking a message or user and selecting "Apps").
This permission does not control whether or not a bot's application commands will appear in your server — that is controlled by the
application.commands
scope set when inviting the bot. Currently, this permission does nothing for bots.
If you are not seeing a bot's commands and you invited it with this scope, you may have too many bots — only 50 bots are allowed to register commands in one server.
link Request To Speak (REQUEST_TO_SPEAK
)
Allows the user to request to become a speaker in stage channels, which can be approved or denied by stage moderators.
link Manage Events (MANAGE_EVENTS
)
Allows the user to create, edit, and delete server events, including starting and ending them.
link Manage Threads (MANAGE_THREADS
)
Allows the user to edit, archive, unarchive, lock, unlock, and delete threads and view all private threads.
link Create Public Threads (CREATE_PUBLIC_THREADS
)
Allows the user to create public threads (which all users can see).
To send messages in threads, the user needs Send Messages In Threads.
link Create Private Threads (CREATE_PRIVATE_THREADS
)
Allows the user to create private threads (which only users with Manage Threads or who are explicitly invited to the thread can see).
To send messages in threads, the user needs Send Messages In Threads.
link Use External Stickers (USE_EXTERNAL_STICKERS
)
Allows the user to send messages with stickers from other servers.
link Send Messages In Threads (SEND_MESSAGES_IN_THREADS
)
Allows the user to send messages in threads and forum posts.
To create forum posts and talk in text and text-in-voice channels, the user needs Send Messages.
link Use Activities (USE_EMBEDDED_ACTIVITIES
)
Allows users to start activities such as YouTube's Watch Together in voice channels. All users may join an existing activity.
link Timeout Members (MODERATE_MEMBERS
)
Allows the user to timeout other members, which disables all permissions except for View Channel and Read Message History. Some features such as adding to existing reactions or using message components (buttons and dropdowns) are also disabled.
Timeouts persist if a member leaves and rejoins the server.
Administrators cannot be timed out. If a user is timed out and gains the permission, their timeout is immediately canceled. Even if an administrator could be timed out, they would be exempt from it.
link View Monetization Analytics (VIEW_CREATOR_MONETIZATION_ANALYTICS
)
Allows the user to view insights on role subscriptions and server monetization.
link Use Soundboard (USE_SOUNDBOARD
)
Allows the user to use the soundboard to play sounds in a voice channel.
link Use External Sounds (USE_EXTERNAL_SOUNDS
)
Allows the user to play sounds from other servers using the soundboard (if the have Use Soundboard).
link Send Voice Messages (SEND_VOICE_MESSAGES
)
Allows the user to send voice messages, which are uploaded as audio files and not automatically played.