Discord basics
How to add a bot to a Discord server
Add a bot to your Discord server with an OAuth2 invite link. Step-by-step guide covering Manage Server, scopes, permissions and common errors.
To add a bot to a Discord server, open the bot's invite link, choose your server, review the permissions it requests and click Authorize. You need the Manage Server permission in that server, or the bot's server will not appear in the list. The invite uses Discord's OAuth2 flow, and for most bots it grants two scopes: bot and applications.commands.
Step-by-step: adding a bot
- Find the bot's invite link, usually on its website or support server.
- Log in to Discord in your browser if prompted.
- Under "Add to server", pick the server you manage.
- Review the permission list shown on the screen.
- Click Authorize and complete the CAPTCHA.
- Open your server and look for the bot in the member list, usually in its own role.
If the server dropdown is empty, you do not have Manage Server in any server, or you are logged into the wrong account.
What do the OAuth2 scopes mean?
A scope tells Discord what the authorization is for.
| Scope | What it does |
|---|---|
bot | Adds the bot as a member of the server with the permissions you approve |
applications.commands | Lets the bot register slash commands in the server |
A bot invited without applications.commands may join fine but its slash commands will not appear. Discord's OAuth2 documentation describes every scope.
What permissions should you grant?
The invite screen shows a checklist of permissions the bot is asking for. Grant what its features need and nothing more. A music bot needs to Connect and Speak in voice, a chat bot needs to View Channels, Send Messages and Read Message History, and a moderation bot needs things like Manage Messages. Avoid giving Administrator unless you fully trust the bot, because it bypasses all channel restrictions. For more, see how Discord permissions work.
What to do after adding the bot
- Check its role. Bots usually get an automatically created role with their name. Move it above any role it needs to manage; see roles and hierarchy.
- Check channel access. Private channels need the bot to be allowed in explicitly; see channel permission overwrites.
- Run its help command to confirm it responds.
- Configure it. Many bots have a dashboard or a setup command.
Common problems
- "Missing Access" or the bot does not respond. The bot likely cannot view or send in that channel because of an overwrite.
- Slash commands missing. The bot was invited without
applications.commands, or Discord has not refreshed yet. Re-invite with both scopes. - Cannot assign roles. The bot lacks Manage Roles or its role is below the target role.
- Bot is in the list but offline. The bot's host is down; nothing you set up in Discord can fix that.
Doing this with Based
The Based invite requests only basic permissions: view channels, send messages, embeds, attach files, read history, and connect and speak in voice. Extra permissions such as Manage Messages or Manage Roles are opt-in, and you grant them only if you turn on a module that needs them. After adding it, run /setup (needs Manage Server) or open the dashboard. Every slash command also works with the "." prefix, such as .help. The add Based doc has the detail.
Frequently asked questions
Why can't I see my server when adding a bot?
You need the Manage Server permission, or be the owner, in that server. Also check that you are logged into the right Discord account in your browser.
What does the applications.commands scope do?
It allows the bot to create slash commands in your server. Without it, the bot may join but its slash commands will not show up.
Can I change a bot's permissions after adding it?
Yes. Edit the bot's role in Server Settings, or adjust channel overwrites. You do not need to re-invite for permission changes.
How do I remove a bot from my server?
Right-click the bot in the member list and choose Kick, or ban it. Deleting its role alone does not remove it.
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
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.
- Discord basics
Discord roles and role hierarchy explained
Discord roles group members and grant permissions. Learn how role hierarchy works, why bots can't assign some roles, and how to order roles correctly.
- 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.
Try it in your server
Based is an AI Discord bot in 300+ servers. Every slash command also works with the "." prefix.