Discord basics
What are Discord gateway intents?
Gateway intents tell Discord which events a bot receives. Learn the privileged intents (Message Content, Server Members, Presence) and why they matter.
Gateway intents are settings a bot declares when it connects to Discord, telling Discord which categories of live events it wants to receive, such as messages, member joins or voice updates. Bots only get events for the intents they request. Three intents are privileged: Message Content, Server Members and Presence. They expose more data and must be enabled by the bot's developer.
How do gateway intents work?
A bot keeps a WebSocket connection to Discord called the Gateway. When it connects (the "identify" step), it sends a number built from intent flags. Discord then sends only the matching events. If a bot does not request the guild messages intent, for instance, it never receives message events. This reduces traffic and limits how much data bots collect. Discord's Gateway documentation lists every intent.
What are the privileged intents?
| Intent | What it gives the bot |
|---|---|
| Message Content | The text, attachments, embeds and components of messages |
| Server Members | Events when members join, leave or change, and access to the full member list |
| Presence | Members' online status and activity |
Developers enable these in the Developer Portal under the bot's settings. Discord requires bots that are in many servers to apply for approval of privileged intents. Check the current threshold in Discord's developer docs rather than assuming a number.
What does the Message Content intent do?
Without it, a bot receives message events but the content field is empty, except for specific cases: messages where the bot is mentioned, messages sent to the bot directly in DMs, and the bot's own messages. That is why traditional prefix commands like .play need the Message Content intent, while slash commands do not, since the command data arrives in an interaction.
What does the Server Members intent do?
It delivers join, leave and update events for members, which welcome messages, auto roles and member lists depend on. Without it, a bot cannot greet new members or reliably see who is in the server.
What does the Presence intent do?
It shows whether members are online, idle or offline and what they are doing. Few bots need it, and many servers prefer bots that do not ask for it.
Why should server owners care about intents?
Intents tell you what a bot is capable of seeing. A bot with Message Content can read ordinary messages in channels it can access; a bot without it cannot. That matters for privacy: check what the bot says it reads, how much it keeps and who it shares it with. Intents are enabled by the developer, not by you, and you cannot toggle them from your server.
Common mistakes (for bot developers)
- Forgetting to enable the intent in the Developer Portal, leading to an "Disallowed intents" error when connecting.
- Requesting privileged intents the bot does not use.
- Expecting message content in guild messages without the intent.
Doing this with Based
Based answers mentions and replies and also supports prefix commands (default "."), so you can type .help as well as /help. Based reads a bounded window of recent messages for conversation context (default 40 messages) and does not archive them. Details are in AI chat and privacy and data.
Frequently asked questions
What are the three privileged gateway intents?
Message Content, Server Members and Presence. A developer must enable each in the Developer Portal, and larger bots must be approved by Discord.
Do slash commands need the Message Content intent?
No. Slash command data comes through interactions, so a bot can run slash commands without reading message content.
Why does my bot receive empty message content?
The Message Content intent is not enabled in the Developer Portal or not included when the bot connects. Bots still see content in DMs, in messages mentioning them and their own messages.
Can a server owner turn intents on or off for a bot?
No. Intents are set by the bot's developer. Owners control what the bot can access through permissions and channel overwrites.
Keep learning
- Discord basics
What is a Discord bot?
A Discord bot is an automated account that runs code to respond to commands and events. Learn how bots work, what they do and how they differ from users.
- Discord basics
Slash commands vs prefix commands on Discord
Slash commands are built into Discord; prefix commands are typed messages like !help. Compare how they work, their trade-offs and which to use.
- Moderation and safety
How do Discord bots handle your data?
What data Discord bots can see and store, how permissions limit access, what to check in a privacy policy, and how to keep your server safe.
- Discord basics
How Discord permissions work
Discord permissions control what members and bots can do. Learn how role permissions combine, what Administrator does and how to fix common issues.
Try it in your server
Based is an AI Discord bot in 300+ servers. Every slash command also works with the "." prefix.