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

URL: https://www.jalkarna.in/based/learn/how-to-add-a-bot-to-a-discord-server/  
Last updated: 2026-11-16

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

1. Find the bot's invite link, usually on its website or support server.
2. Log in to Discord in your browser if prompted.
3. Under "Add to server", pick the server you manage.
4. Review the permission list shown on the screen.
5. Click **Authorize** and complete the CAPTCHA.
6. 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](https://www.jalkarna.in/based/learn/slash-commands-vs-prefix-commands/) in the server |

A bot invited without `applications.commands` may join fine but its slash commands will not appear. Discord's [OAuth2 documentation](https://discord.com/developers/docs/topics/oauth2) 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](https://www.jalkarna.in/based/learn/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](https://www.jalkarna.in/based/learn/discord-roles-and-role-hierarchy/).
- **Check channel access.** Private channels need the bot to be allowed in explicitly; see [channel permission overwrites](https://www.jalkarna.in/based/learn/discord-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](https://www.jalkarna.in/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](https://www.jalkarna.in/based/dashboard/). Every slash command also works with the "." prefix, such as `.help`. The [add Based doc](https://www.jalkarna.in/based/docs/add-based-to-your-server/) has the detail.


## FAQ

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

## Related
- [What is a Discord bot?](https://www.jalkarna.in/based/learn/what-is-a-discord-bot/)
- [How Discord permissions work](https://www.jalkarna.in/based/learn/how-discord-permissions-work/)
- [Discord roles and role hierarchy explained](https://www.jalkarna.in/based/learn/discord-roles-and-role-hierarchy/)
- [Slash commands vs prefix commands on Discord](https://www.jalkarna.in/based/learn/slash-commands-vs-prefix-commands/)
