# 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.

URL: https://www.jalkarna.in/based/learn/what-are-discord-gateway-intents/  
Last updated: 2026-11-16

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](https://discord.com/developers/docs/topics/gateway#gateway-intents) 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](https://www.jalkarna.in/based/learn/slash-commands-vs-prefix-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](https://www.jalkarna.in/based/learn/how-discord-bots-handle-your-data/): 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](https://www.jalkarna.in/based/docs/ai-chat/) and [privacy and data](https://www.jalkarna.in/based/docs/privacy-and-data/).


## FAQ

### 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.

## Related
- [What is a Discord bot?](https://www.jalkarna.in/based/learn/what-is-a-discord-bot/)
- [Slash commands vs prefix commands on Discord](https://www.jalkarna.in/based/learn/slash-commands-vs-prefix-commands/)
- [How do Discord bots handle your data?](https://www.jalkarna.in/based/learn/how-discord-bots-handle-your-data/)
- [How Discord permissions work](https://www.jalkarna.in/based/learn/how-discord-permissions-work/)
