> For the complete documentation index, see [llms.txt](https://docs.rivalryze.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rivalryze.com/for-guild-admins/adding-the-bot.md).

# Adding the Bot to Your Server

The RivalRyze bot brings RivalRyze into your Discord server: an activity feed of what members play and complete, a forum for your server's Contests, leaderboards and profile cards through slash commands, and server activity stats. Adding the bot and registering your server as a **Guild** happen in the same flow on the website.

## Who can add the bot

You need to be the server owner, or hold the **Manage Server** or **Administrator** permission on the Discord server. Discord only lists servers where you have that permission, and RivalRyze checks it again before it registers the server as a Guild.

If you don't have it, ask the server owner to add the bot or to grant you the permission.

## Add the bot from the website (recommended)

1. Sign in on [rivalryze.com](https://rivalryze.com) and make sure your Discord account is connected. See [Connecting Discord](/connecting-gaming-platforms/discord.md).
2. Open **Guilds** in the sidebar and click **Add RivalRyze to Discord**. The same button is on the **Bot** page (`rivalryze.com/guilds/about`).
3. In the **Add the RivalRyze App to your Discord** dialog, click **Add RivalRyze to Discord**. If your Discord account isn't connected yet, the dialog asks you to connect it first.
4. Discord opens its authorization screen. Pick your server, review the permissions and confirm.
5. You come back to your new Guild's page on RivalRyze, where a short setup dialog starts.

Continue with [Initial Setup](/for-guild-admins/initial-setup.md).

## Add the bot from Discord

You can also add the bot from a server that already has it:

* Run `/invite`. The bot replies privately with an invite link.
* Or click **Add App to Server** on the bot's welcome message in a RivalRyze `#info` channel.

The link takes you through the same Discord authorization screen and back to RivalRyze, which registers the server as a Guild for your account.

If the bot ends up in a server that isn't registered as a Guild, it sends the server owner a direct message with a setup guide and a **Create Your Guild** button, and `/setup` shows the same guide.

{% hint style="info" %}
If you authorize an invite link with a Discord account that has no RivalRyze account, you're sent to the sign-up page instead. Create your account, connect Discord, then finish with **Create Your Guild**.
{% endhint %}

## Permissions

Discord shows the permissions the bot asks for on its authorization screen. You can change them later in **Server Settings → Roles**, on the bot's role. The [Bot Permissions Checklist](/for-guild-admins/bot-permissions.md) explains what each permission is used for and how to check them with `/guild-permissions`.

## What happens when the bot joins

* The bot is marked **Online** on your Guild page (**RivalRyze bot is active**).
* The Discord server owner receives the setup guide by direct message (if their DMs are open).
* If you came from the website, your Guild is created and you become its **Owner**.

Nothing is posted in your server until you sync the RivalRyze channels during [Initial Setup](/for-guild-admins/initial-setup.md).

## Removing the bot

Kick the bot from your server in Discord, like any other member.

* Your Guild page shows the bot as **Offline** (**RivalRyze bot is inactive**).
* Activity feed posts, Contest threads and server activity tracking stop.
* Your Guild page, its members and its history stay on RivalRyze.

To bring the bot back, add it again with the same steps. There is no button on the website to delete a Guild.

## Bot not responding?

1. Check that the bot appears online in your server's member list.
2. If you're the guild's owner or an admin, run `/guild-permissions` to check its access to your channels.
3. See the [Bot Permissions Checklist](/for-guild-admins/bot-permissions.md) and [Bot Commands Reference](/for-guild-admins/bot-commands-reference.md#command-not-working).
4. If it's still not working, [contact support](/help-and-faq/contact-support.md).