πŸ”“ Permissions

πŸ”“ Permissions#

The permissions given to members is an important part in the configuration of a server. The same is also true for bots. This page is intended to show you each of the permissions necessary for the bot, as well as explain why they are necessary. All this in order to avoid putting unnecessary permissions on the bot, which it turn will keep your server clean and safe.

Warning

Never never never NEVER never (yes, 5 times never) put a bot with administration permissions. It has already happened once that the bot’s security key is stolen, which allows the thief to take full control of the bot, such as deleting your channels or banning your members. Even though safety has been completely redesigned since this incident, zero risk is not possible. See this official note from Discord for more information.

General Permissions#

Administrator#

Grant every possible permission in the server. Someone with this permission will not have any restriction, except deleting the server and editing the roles above them. Not recommended to anyone, even a bot.

View Audit Log#

Allows the bot to read server logs (adding roles, changing names, editing channels…). Used by the modlogs system.

Manage Server#

Allows the bot to change the name, image and region of the server, or get the list of all invites. Used for: invite

Manage Roles#

Allows the bot to create and delete roles, or edit the permissions of roles lower than his own, and to give them to other members. Examples of use: mute, voice roles

Manage Channels#

Allows the bot to create, delete and modify channels (create invitations for example). Examples of use: membercounter option, voice channels automation

Kick Members#

Allows the bot to eject a member from the server. Examples of use: kick anti-raid system

Ban Members#

Allows the bot to ban or unban a member from the server, as well as to consult the list of banned members. Examples of use: ban , unban, banlist, softban

Time out Members#

Allows the bot to temporarily mute a member, preventing them to send messages, add reactions, and speak in voice channels. Examples of use: mute

Create Invite#

Allows the bot to create invitations to any visible room, without being able to modify or delete them. Not used.

Change Nickname#

Allows the bot to change your own nickname. Not used at this moment.

Manage Nickname#

Allows the bot to change the nickname of any member hierarchically equal or inferior to you. Example of use: unhoist command

Manage Expressions#

Allows the bot to add, rename or delete emojis and stickets from the server. Example of use: emoji

Manage Webhooks#

Allows the bot to read, add, modify or delete webhooks . Example of use: infos

Read Text Channels & See Voice Channels#

Allows the bot to see chats and voice channels. This permission does not allow you to write in these chats or connect to the voice channels. Required for the bot.

Create/Manage Events#

Allows to create, edit and cancel server events. Not used by the bot.

Send polls#

Allows users to send polls in your channels. Not available to bots at the moment.

Text Permissions#

Read Messages/See channel#

Allows the bot to read messages from a chat, but not the history. In other words, the bot will react to your messages but will not be able to read them again. Remove this permission in a channel to prevent the bot from being there.

Send Messages / Send Messages in Threads#

Allows the bot you to write messages in text channels and threads. Required for almost all functionalities, but not necessarily for all channels.

Create Public/Private Threads#

Allows the bot to create public or private threads in text channels. Required for the tickets system when configured to create threads.

Send TTS Messages#

Allows the bot to send a TTS (text-to-speech) message, i.e. a message that will be read aloud by your application. No need for the bot.

Attach Files#

Allows the bot to send files (such as images) in a channel. Examples of use: fun commands, XP cards

Read Message History#

Allows the bot to read the history of all messages in a channel. Examples of use: clear , purge , some fun commands

Mention @veryone, @here and All Roles#

Allows the bot to mention any role including @everyone (which results in sending a notification to all members with access to the channel) and @here (sends a notification to all online members with access to the channel). Axobot uses a great Discord protection to avoid unwanted mentions, so you should be safe granting it. Example of use: rss follows with mentions

Use External Emojis#

Allows the bot to use emojis from any other server. The bot uses them in many situations to diversify emotions, so it is strongly recommended to keep it activated.

Use External Stickers#

Allows the bot to use stickers from any other server. Bots cannot use stickers atm, so this permission has no effect.

Manage Messages#

Allows the bot to pin or delete any message. Examples of use: mute , freeze , clear , purge , fun commands

Manage Threads#

Allows the bot to edit and delete threads. Not used at this moment.

Add Reactions#

Allows the bot you to add reactions to a message, whether they are Discord or server emotions. Examples of use: react, poll command, poll channels

Use Application Commands#

Allows the user to use bots commands (ie. slash commands as well as user and message context commands). Obviously has use for bots.

Voice Permissions#

Connect#

Allows the bot to connect in this voice channel. It is also required to edit this channel. Examples of use: membercounter option, voice channels automation

Speak#

Allows the bot to speak in a voice chat room. No use for the moment.

Video#

Allows users to share their screen or their camera. Bots cannot use that for now.

Mute Members#

Allows users to mute other users in voice channels. Not used.

Deafen Members#

Allows users to deafen other users in voice channels. Not used.

Move Members#

Allows the bot to move members from a voice channel to another. The bot needs to have access to that other channel, but not necessarily the affected member. Example of use: voice channels automation

Use Voice Activity#

Allows users to use voice detection instead of push-to-talk. Makes no sense for bots.

Priority Speaker#

Allows users to have their volume higher than the other members in a voice channel. Bots cannot use that for now.

Request To Speak#

Allows users to raise their hands in stage channels. Not used by Axobot.