Add YourBot to a server

Invite the bot

Use the Add to Server button on the home page, or open yourbot.gg/invite. Discord asks you to pick a server and shows the permissions the bot is requesting. You need Manage Server on that server to add a bot.

The invite adds two things at once: the bot user, and the application commands (the slash commands you see when you type /). If the commands do not appear right away, Discord can take a minute to show them. Switching channels or restarting the Discord client refreshes the list.

What the invite asks for

The invite requests every permission the ten built-in services can need, so you do not have to come back and re-invite when you turn a service on later. Each service's page in these docs lists the subset it actually uses under Permissions the bot needs, for example Moderation or Voice Channels.

If you remove a permission after inviting, the service that needs it shows a re-grant banner in the dashboard, and the affected commands reply with what they cannot do instead of failing silently. To check every enabled service at once, run the setup check: Run the check on the Setup Check card of the Bot page, or /yourbot check in Discord. It lists every missing permission and where the bot needs it.

The bot never asks for Administrator.

Where the bot needs to be able to see

A permission grants the ability. Channel overwrites decide where. The bot can only act in channels it can view, so:

• If a service should post in a private channel (a staff log, a ticket category), give the bot's role access to it, or pick a channel it can already see.
• The Moderation and Tickets setup wizards create their private channels with the bot's overwrite in place.

The setup check takes these overwrites into account, so it names each channel or category where the bot is missing something.

The first five minutes

1. Type /yourbot in any channel. It tells you whether the server is set up and offers a quick start for the services you pick.
2. Open the dashboard and choose the server. Every service has an Enabled or Disabled switch on the Services page.
3. Turn on one service and follow its First step on its docs page. Most services have a setup wizard or a single required setting. Then run /yourbot check to see whether the bot can do everything the service is set up to do.
4. Visit Services, then the service, then Commands to decide who can run what. The Moderation preset is a good default: staff roles get the staff commands, everyone else keeps the member ones. See Command Access and presets.
5. Set the Server Timezone on the Bot page if your community is not in UTC. Schedules and daily statistics follow it. See Server timezone.

Shared bot or your own bot

The invite above adds the shared YourBot. You can instead run the same platform under your own bot name and avatar with a subscription. See Shared bot vs custom bot.

A subscribed server that stays on the shared bot can give it its own picture, banner and about me in that server. Every other server keeps seeing the normal YourBot. See How the bot looks in your server.