How to use the calculator
- Tick only the permissions your bot needs.
- Copy the integer shown above.
- Paste it into the permissions part of an invite link, or use it in your code.
A bot invite link looks like this, with your application's client ID and your integer:
https://discord.com/oauth2/authorize?client_id=YOUR_ID&scope=bot+applications.commands&permissions=68608
The bot scope adds the bot to the server, and applications.commands lets it register slash commands.
What the number means
Discord stores permissions as a bit set. Each permission owns one bit, and the integer is all the chosen bits added together. For example, View Channels is 1024, Send Messages is 2048 and Read Message History is 65536, so a bot with those three has the value 68608. The API sends these values as strings, because the numbers have grown too large for some languages to hold safely in a normal integer. If you handle them in code, treat them as big integers.
What the key permissions do
- Administrator (8): grants every permission and ignores channel overrides.
- Manage Server (32): changes server settings such as the name and icon.
- Manage Roles (268435456): creates and edits roles below the bot's own highest role.
- Manage Channels (16): creates, edits and deletes channels.
- Kick Members (2) and Ban Members (4): remove people, but only those whose top role is below the bot's.
- Manage Messages (8192): deletes and pins other people's messages.
- Manage Webhooks (536870912): creates webhooks, which can post under any name and avatar.
- Mention Everyone (131072): allows pings to @everyone, @here and all roles.
Why Administrator is risky
Administrator is the easy choice and the worst default. It gives a bot full control and skips every channel restriction you set up. If that bot has a security problem, or its token leaks, whoever holds the token can delete channels, ban members and hand out roles. A good bot tells you which permissions it needs and works with those. Be careful with any bot that demands Administrator without a clear reason, and read our guide to Discord safety.
Why can my bot still not do something?
The integer is only part of the picture. Channel overrides can deny a permission in one channel, and the role hierarchy limits moderation: a bot can only kick, ban or change nicknames for users whose highest role is lower than its own. Move the bot's role up in Server Settings if this is the problem.
Do I need Administrator for a moderation bot?
Usually no. Most moderation bots need a short list such as Kick Members, Ban Members, Manage Messages and Moderate Members. Check the bot's own documentation.
Can I change permissions after adding a bot?
Yes. A server admin can edit the bot's role at any time, so a new invite link is not needed for most changes.
What does permissions=0 do?
The bot joins with no permissions of its own, and gets only what its roles and the server's defaults allow.
Picking a bot? See our list of the best Discord bots. The ID lookup helps when a setting asks for an ID.