> For the complete documentation index, see [llms.txt](https://docs.appy.bot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.appy.bot/getting-started/set-up/custom-bot.md).

# Custom bot

A page explaining how to setup custom bots

Use Appy with your own bot name, avatar and status. You need an active Custom Bot subscription and an available bot slot. Each custom bot can be assigned to one server at a time.

## Start the setup

Open the [Custom Bot tab](https://appy.bot/dashboard?selected=custom-bot) and click **Create Bot**. Read the introduction, tick the confirmation and click **Next**.

## Create your Discord bot

1. Open the [Discord Developer Portal](https://discord.com/developers/applications) and create a new application.
2. Open its **Bot** page and click **Reset Token**. Copy the new token into Appy's **Input bot token** step.
3. Click **Next** to check the token.

{% hint style="warning" %}
Keep your bot token private. Enter it only in Appy's token field; do not include it in screenshots or support messages.
{% endhint %}

## Add the redirect URLs

Open **OAuth2** in your Discord application's settings and add both URLs under redirects:

```
https://appy.bot/callback/discord
https://appy.bot/return
```

Save your changes in Discord, then tick the confirmation in Appy and click **Next**.

## Enable the gateway intents

On the Discord **Bot** page, enable **Presence Intent**, **Server Members Intent** and **Message Content Intent** under **Privileged Gateway Intents**. Leave **Require OAuth2 Code Grant** off.

Save in Discord, then confirm the intents in Appy and click **Next**.

## Choose your server

Choose the server in Appy's final step and click **Finish**. Before inviting the custom bot, remove the main Appy bot from that server. Your saved server settings are kept.

Click **Invite bot** on the new bot card and complete Discord's invite flow. You can now change its **Custom bot name**, **Bot avatar**, **Bot Status** and **Activity Text**, then click **Save changes**. The card also has a **Restart bot** button.
