Discord permissions calculator
Work out your Discord bot permissions integer and build its OAuth2 invite link. Free, runs in your browser, no account needed.
Tick the permissions your bot needs: the tool computes the integer for the invite link and builds the OAuth2 URL. Everything runs in your browser.
What is the Discord permissions integer?
Every Discord permission is one bit. The permissions integer is the sum of the values of the permissions granted: View Channels (1024) plus Send Messages (2048) gives 3072. Administrator alone is 8.
Discord reads this integer from the permissions parameter of the invite link. When the bot is added, it creates a managed role named after the bot with exactly those permissions. Paste an integer into the calculator to see which permissions it contains.
The bot invite link
The install link looks like https://discord.com/oauth2/authorize?client_id=…&permissions=…&scope=bot%20applications.commands. The client_id is the application ID, shown in the Developer Portal on the General Information page.
The bot scope adds the bot user to the server and applies the requested permissions; applications.commands allows slash commands. The link holds no secret: never paste your bot token into an online tool.
Values of the most used permissions
Official values from the Discord documentation, to be added together.
| Constant | Value | What it allows |
|---|---|---|
| VIEW_CHANNEL | 1024 | View channels and read their messages |
| SEND_MESSAGES | 2048 | Send messages |
| EMBED_LINKS | 16384 | Show link previews and embeds |
| ATTACH_FILES | 32768 | Upload files and images |
| READ_MESSAGE_HISTORY | 65536 | Read messages sent before it joined |
| MANAGE_MESSAGES | 8192 | Delete other members’ messages |
| KICK_MEMBERS | 2 | Kick members |
| BAN_MEMBERS | 4 | Ban members |
| MODERATE_MEMBERS | 1099511627776 | Time out members |
| MANAGE_ROLES | 268435456 | Assign and edit roles |
| CONNECT | 1048576 | Join a voice channel |
| SPEAK | 2097152 | Speak in a voice channel |
| ADMINISTRATOR | 8 | Every permission, no exception |
Good practice
- Ask for the minimum: a bot that answers commands needs View Channels, Send Messages, Embed Links and Read Message History.
- Avoid Administrator: it grants everything and ignores channel settings. A compromised bot would then have full rights on the server.
- Put the bot role above the roles it assigns and the members it moderates: Discord blocks any action on a higher role.
- Channel permissions can take away a right granted at server level: check them if the bot only answers in some channels.
- Pinning messages now has its own permission (PIN_MESSAGES), separate from Manage Messages.
Frequently asked questions
How do I calculate Discord bot permissions?
Add up the value of each permission granted: View Channels is 1024, Send Messages 2048, Embed Links 16384. The calculator adds them as soon as you tick a box and builds the invite link.
Which permissions should a Discord bot get?
Only what it needs. For a command bot: View Channels, Send Messages, Embed Links and Read Message History. Add moderation (kick, ban, time out) only if the bot moderates, and avoid Administrator.
Where do I find my bot client ID?
In the Discord Developer Portal: open your application, General Information page, Application ID field. It is a public number of 17 to 20 digits, not to be confused with the bot token.
Why does my bot lack permissions after the invite?
Three common causes: the bot role sits below the roles it must manage, a channel permission removes the right, or the bot was invited with an old integer. Edit its role in the server settings or invite it again with the new link.
Does the calculator send my data anywhere?
No. The integer and the link are computed in your browser; nothing is sent to ACLClouds or Discord. The tool never asks for the bot token.