Tolz.me

Discord Permissions Calculator: What Is My Permission Integer?

Tick Discord permissions to build the role integer, or paste an integer to update the boxes. Both ways work live, and the result turns into a bot invite link.

Check permissions to build the integer, or type an integer to update the checkboxes. Every value is calculated with BigInt in your browser, so large bitfields stay exact.

Decimal or hex with a 0x prefix. Typing here updates the checkboxes below.

Decimal
0
Hex
0x0
Permissions on
0 of 52
General
Membership
Text
Voice
Events
Advanced

Administrator grants every permission and bypasses channel overwrites, so a role with that bit ignores every deny rule set on a channel.

The Discord API sends the permissions field as a string. Keep the value in quotes in bot config files.

Bot invite link

Optional. Add your application client ID to build an install link that requests these permissions.

A client ID is a snowflake of 17 to 20 digits from the Developer Portal.

About this tool

This Discord permission calculator works in both directions. Tick the permissions a role needs and it adds up Discord's official bit table into one integer, or paste an integer in decimal or hex and the checkboxes rebuild themselves from it. The list covers the 52 permissions Discord defines today, grouped the way Server Settings groups them. Add a client ID to turn the result into a bot install link, and see any bits Discord does not recognise before you save the value to a config file.

Browse more discord tools or explore all Tolz.me tools.

Try other relevant tools

Frequently asked questions

What is a Discord permission integer?+

One number that holds every permission a role has. Each permission owns one bit in it, so a role that can send messages and kick members carries two bits set. Discord stores role permissions this way, and bots read the same number to know what they may do.

How do I use the permission calculator?+

Both fields are live. Tick a box and the integer field rewrites itself with the new total. Type or paste an integer in decimal or with a 0x hex prefix and the checkboxes update as you go. The output row shows the value in decimal and hex, plus a count of the permissions you have on.

What does the Administrator permission do?+

Administrator grants every permission and bypasses channel overwrites, so a role with that bit ignores deny rules on a private channel. Keep it for a small owner tier. A moderator preset without that bit covers most moderation work.

Why does my value contain bits Discord does not recognise?+

Bit 47 is unused in Discord's table, and Discord adds new permissions by taking the next free bit, so values from a newer API version can carry bits this table does not name. The tool lists those bits in a warning instead of dropping them silently.

Should I store a permission value as a number or a string?+

As a string. Large combinations pass 2^53, the point where normal JavaScript numbers lose precision, and the Discord API sends the permissions field as a string. Keep it quoted in config files.

How do I build a bot invite link with these permissions?+

Enter your application client ID, a snowflake of 17 to 20 digits from the Developer Portal. The tool builds https://discord.com/oauth2/authorize with your client ID, the current integer, and the bot plus applications.commands scopes. Copy it or open it straight from the tool.

Are channel overwrites included in the value?+

No. The integer holds role level permissions only. Channel specific allow and deny overwrites are stored on the channel and managed inside each channel's permission settings.

Is the Discord permission calculator free?+

Yes. The arithmetic runs in your browser with BigInt, nothing is uploaded, and no account is needed.

Use cases

  • Configure a bot role with the exact permissions your bot needs before sharing the OAuth invite link.
  • Audit an existing moderator role by pasting its integer to see which permissions it grants.
  • Build a bot install link that requests one specific permission set instead of everything.
  • Cross-check a permission integer from a bot config file against Discord's official bit table.
  • Plan tiered roles for a growing server with separate admin, moderator and member levels.

Discord Permissions Calculator: What Is My Permission Integer?

Your permission integer is the sum of the bit values of every permission you tick, and the calculator above gives you that number in decimal and hex the moment a checkbox changes. Paste an integer you already have into the same field and the checkboxes rebuild themselves, so the tool works for building a role and for auditing one.

What the permission calculator does

Discord keeps a role's permissions in a single integer. Each permission owns one bit in it, so a role that can send messages and kick members carries two bits set. This calculator adds up the bits you tick and decodes an integer you already have back into named permissions. Both directions run in your browser using BigInt arithmetic, so a value above 2^53 keeps every digit instead of losing precision.

The list follows Discord's official permission table at https://discord.com/developers/docs/topics/permissions. It covers every permission Discord defines today: bits 0 to 46 and bits 48 to 52, which is 52 permissions in total. Bit 47 is not used by Discord.

How to use it

Work in either direction. To build a value, tick the permissions your role needs and read the decimal number from the output row. The integer field at the top of the tool rewrites itself as you go. To decode a value, type or paste it into that field in decimal or with a 0x hex prefix, and the checkboxes update live. Nothing is uploaded, and the value never leaves the page.

The quick actions above the list save typing. Select all gives you the full set of 52 permissions. Clear empties the selection. The Moderator preset covers kicking, banning, timeouts, message and thread moderation, nicknames and voice control. The Basic bot preset is the smaller set most bots need: View Channel, Send Messages, Embed Links, Attach Files, Read Message History, Add Reactions, Use Application Commands and Send Messages in Threads.

Permissions are grouped the way Discord groups them in Server Settings: General, Membership, Text, Voice, Events and Advanced. Every row shows the label Discord displays, the bit number and the API name, so you can match a value against the docs or against a bot config file.

Discord's current limits

Discord's permission table currently defines 52 permissions across bit positions 0 to 46 and 48 to 52. Bit 47 sits in the middle of that range and is left unused, which is why a value that sets bit 47 looks plausible but grants nothing. Discord adds permissions over time by taking the next free bit, so a number saved by an older table can hold bits that no longer have a name.

The authoritative table lives at https://discord.com/developers/docs/topics/permissions. That page lists every bit with its value and what it allows, and it is the place to check when a permission name here does not match the one in a bot's README.

Permission values get large. The largest combination, Administrator plus every other bit, sits well past 2^53, the point where ordinary JavaScript numbers start dropping digits. That is why the calculator uses BigInt and why you should keep permission values as strings in your own code. The Discord API sends the permissions field as a string, so a config file with permissions: "274881971712" is the correct shape.

Building bot invite links

Any value you build here can go straight into a bot install link. Add your application client ID, a snowflake of 17 to 20 digits from the Developer Portal, and the tool builds the link in the format Discord documents under OAuth2 at https://discord.com/developers/docs/topics/oauth2:

https://discord.com/oauth2/authorize?client_id=YOUR_CLIENT_ID&permissions=VALUE&scope=bot%20applications.commands

The scope pair asks for the bot scope and the applications.commands scope, which is what lets a bot register slash commands. The permissions parameter is the integer from the output row. Copy the link and open it to walk through Discord's install screen, or send it to your team.

A smaller number means less access. The Basic bot preset is a sensible starting point for a bot that reads and posts in a few channels. Grant the bot View Channel and Send Messages only when it needs them, since the role you accept at install time applies everywhere the bot can reach.

Edge cases and things to watch

Administrator overrides everything else. When that bit is set, Discord grants every permission and ignores channel overwrites, including deny rules on a private channel. A decoded value can show Send Messages as off while Administrator is on, and the member still gets access. Check the Administrator bit first when a role appears to have more power than its integer suggests.

Undefined bits are flagged rather than hidden. When a value sets a bit Discord does not define, the calculator lists it in a warning. Bit 47 is the expected gap inside the current range. Anything above bit 52 comes from a newer API version and is ignored by Discord until that permission ships.

Channel overwrites live outside the integer. A role can be allowed View Channel server wide and denied in one category. Those exceptions are stored on the channel rather than on the role, so no bitfield can show them. Plan private channels with the overwrite settings in Discord rather than with permissions.

Hex and decimal are the same number. A config file may show a value in hex, sometimes with a 0x prefix, and Discord accepts either form. The field takes both and updates the boxes the same way.

Zero is a valid value. A role with no permission bits has the integer 0, and members with that role keep whatever the default role allows them to do.

Frequently asked questions

How many permissions does Discord define? 52, spread across bits 0 to 46 and 48 to 52. Bit 47 is unused.

Should I store a permission value as a number or a string? As a string. Values can exceed 2^53, where normal JavaScript numbers lose precision, and the Discord API expects a string in the permissions field.

Does the calculator send my data to Discord? No. The arithmetic happens in your browser and the page makes no requests with your value.

Which preset fits a new bot? Basic bot for posting and reading messages. Add permissions one at a time as the bot asks for them.

Why did my value decode to fewer permissions than expected? Administrator adds permissions that never had their own bit set, and any bits Discord does not know are ignored. Check the Administrator box and the warning about undefined bits.

Explore more discord tools on Tolz.me.

Related tools