Discord Permission Calculator
Select the permissions you need and instantly generate the correct Discord permission integer for bot invite links and role configuration. No manual bitwise math required.
Building a Discord bot? Read our Complete Guide to Discord Permission Integers.
Discord Permission Calculator Tool
Calculated Permission Integer
0
How to Use the Discord Permission Calculator
- 1Check each permission your role or bot needs. The integer updates live as you toggle.
- 2Copy the generated permission integer from the output field.
- 3Paste it into your bot invite URL as the
?permissions=parameter, or use it in API calls.
How Discord Permission Integers Work
Discord stores every permission as a single bit inside a 64-bit integer. Each of the 64 bit positions maps to one specific permission flag. When a bit is 1, that permission is granted. When it is 0, it is denied. To combine multiple permissions you perform a bitwise OR across all the individual flag values, producing one number that encodes the entire permission set.
For example, KICK_MEMBERS has a value of 2 (bit 1) and BAN_MEMBERS has a value of 4 (bit 2). A role with both permissions has an integer of 6. Our calculator does this accumulation automatically as you toggle permissions.
Using the Integer in Bot Invite URLs
When you invite a bot through Discord's OAuth2 flow, you can pre-select its permissions by appending the integer to the invite URL:
The server admin who clicks the link sees those permissions pre-checked in the authorization screen. They can still deselect individual permissions before approving, but starting with the right integer reduces friction and avoids under-permissioning your bot.
The Permission Hierarchy
Effective permissions for a user in a channel are resolved in three layers. The @everyone role provides the base. Each additional role the user holds is OR'd on top, expanding the permission set. Finally, channel-level permission overwrites apply as the last layer they can explicitly allow permissions not in the role set, or explicitly deny permissions that roles would otherwise grant.
The Administrator permission (bit 3, value 8) is a special case: it bypasses all other checks and grants every permission unconditionally, including overriding channel-level denies. For this reason, avoid granting Administrator to bots unless absolutely required.
Security-Sensitive Permissions
The following permissions carry elevated risk and should only be granted to carefully reviewed roles and bots:
- Administrator Full unrestricted server access.
- Manage Guild Can change server settings, vanity URL, and integrations.
- Manage Roles Can modify roles below the actor's highest role, enabling potential privilege escalation.
- Mention Everyone Can ping @everyone and @here, sending notifications to all members.
- Manage Webhooks Can create and delete webhooks, potentially bypassing moderation logging.
- Manage Messages Can delete any message in channels where this permission is granted.
Discord Permission Calculator FAQ
What is a Discord permission integer?
A Discord permission integer is a 64-bit number where each bit represents one permission flag. Combining permissions produces a single integer that Discord uses to determine what a role or bot is allowed to do.
How do I use this Discord permission calculator?
Toggle the checkboxes for each permission you want to grant. The calculator instantly shows the resulting integer. Copy it and paste it into your bot invite URL or API request.
How do I add the permission integer to a bot invite link?
Add a ?permissions=INTEGER parameter to your OAuth2 invite URL: https://discord.com/api/oauth2/authorize?client_id=YOUR_ID&permissions=YOUR_INTEGER&scope=bot
What does the Administrator permission do?
The Administrator permission grants all other permissions unconditionally and overrides all channel-level permission restrictions. Only grant it to fully trusted bots or roles.
Can permission integers be negative?
Some libraries return permission integers as signed 64-bit integers, which can appear negative in certain languages. Discord's API accepts both signed and unsigned representations. Our calculator outputs the standard unsigned integer.
Do channel overwrites override role permissions?
Yes. Channel permission overwrites are the final layer and can explicitly allow or deny specific permissions for a role or user in that channel, overriding the base role permission integer.
Verified by the FreeDiscordTools Editorial Team
Our online tools are built and tested client-side to ensure absolute data privacy. Learn about our verification standards, calculation reviews, and technical crew on our About page.