Docs / Getting started / Add YourBot to a server

Add YourBot to a server

Invite the bot, what the invite asks for, and the first five minutes.

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.

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

YourBot docs Reference tables are generated from the code that is running. Ask in Discord Suggest a correction