What is a Discord permission integer?

A Discord permission integer is a 64-bit number where each bit position represents one specific permission. Setting a bit to 1 grants that permission. Combining multiple permissions produces a single integer that Discord uses for roles and bot authorization.

How do I calculate a Discord permission integer?

Use our Discord Permission Calculator — toggle the permissions you need and the integer updates live. For manual calculation, sum the individual permission values: KICK_MEMBERS=2, BAN_MEMBERS=4, ADMINISTRATOR=8, etc.

How do I add a permission integer to a bot invite link?

Append ?permissions=INTEGER to your OAuth2 URL: https://discord.com/api/oauth2/authorize?client_id=YOUR_BOT_ID&permissions=INTEGER&scope=bot. The permissions will be pre-checked when server admins authorize your bot.

What does the Administrator permission do in Discord?

The Administrator permission (bit 3, value 8) grants all other permissions unconditionally and bypasses all channel-level permission overrides. Never grant it to bots unless absolutely required.

Can Discord permission integers be negative?

Some programming languages return 64-bit integers as signed, making large values appear negative. Discord accepts both representations. Our calculator always outputs the standard unsigned integer.

Discord Permission Integers: The Complete Guide for Bot Developers

The Pain of 403 Forbidden "Missing Permissions" Errors

Setting up a new Discord bot should be easy, but you're constantly hit with "Missing Permissions" errors in chat, or your bot fails to execute commands. To fix this, developers often resort to giving their bot full "Administrator" permissionswhich is a massive security hazard. If your bot's token is ever compromised, attackers can delete channels, ban members, and destroy the server. The correct solution is calculating the exact permission integer your bot needs.

At its core, Discord represents permissions as a single large integer. Each individual permission like "Send Messages," "Manage Roles," or "Administrator" corresponds to a specific bit position in that integer. Our Discord Permission Calculator handles all of this math for you just toggle the permissions you want and get the resulting integer instantly.

The Math of Discord Permissions: Bitwise Flags

Permissions are represented as bit flags. For example:

Send Messages: Bit 11, value 2048
Embed Links: Bit 14, value 16384
Read Message History: Bit 16, value 65536

Combining these three permissions requires a bitwise OR operation, resulting in: 2048 + 16384 + 65536 = 83968. When you register a bot, you append this integer to the invite URL so the server admin knows exactly what permissions the bot is asking for.

The Principle of Least Privilege

Security Warning: Avoid requesting "Administrator" (Bit 3, value 8) unless it is absolutely necessary. Administrator permissions bypass all channel overrides and give full control. Scoped permissions are far safer and build trust with server owners.

How to Generate the Perfect Permission Integer

Open the Permission Calculator.
Toggle the specific permissions your bot requires.
Copy the generated permission integer.
Construct your invite URL: https://discord.com/api/oauth2/authorize?client_id=YOUR_BOT_ID&permissions=YOUR_INTEGER&scope=bot