All articles
Tech4 min read

Privileged intents explained: why your bot needs Server Members and Message Content

“Used disallowed intents” is one of the most common errors when starting a bot. What intents are, which ones are privileged and how to enable them.

Intents define which events Discord tells your bot about, for example new messages, joins or reactions. The bot requests them when it starts. Three of them are privileged: Discord only provides them if you explicitly enable them in the Developer Portal.

The three privileged intents

  • Server Members: needed for welcome messages, automatic roles on join and member lists.
  • Message Content: needed to read the content of messages, e.g. for auto moderation or levels based on messages.
  • Presence: online status and activities of members. Very few bots need it.

Typical error

If the bot requests a privileged intent that isn't enabled in the portal, Discord closes the connection right away. The console then shows:

Error: Used disallowed intents

How to enable them

  • Open discord.com/developers/applications and select your application.
  • Go to the Bot tab and scroll to Privileged Gateway Intents.
  • Enable the intents listed in your bot's README and save.
  • Restart the bot.

Stricter from 100 servers on

Once a bot is on 100 or more servers, it has to be verified by Discord. Privileged intents are then only granted with a reason and approval from Discord. For your own bot on your server this doesn't matter: the switch in the portal is enough.