ACLClouds
ACLClouds

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.