> For the complete documentation index, see [llms.txt](https://docs.imperialcad.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.imperialcad.app/api-and-integrations/discord-bot.md).

# Discord Bot

The ImperialBot is the official public bot from Imperial Software Solutions that integrates your Discord server directly into your ImperialCAD community.

This integration allows you to:

* Sync your community between ImperialCAD and Discord.
* Control access with features like auto-join and auto-kick.
* Provide members with seamless roleplay and CAD access tools inside Discord.

> ⚡ Available on **Standard+ plans and above**.

***

### 📖 Setup/Install Guide

#### Step 1: Open Integrations

* From the **Admin Panel**, navigate to **Settings → Integrations**.
* Under **Discord**, click **Add Bot to Discord**.

***

#### Step 2: Authorize the Bot

* You’ll be redirected to Discord’s authorization page
* Select the server you want to add **ImperialBot** to
* Ensure you have **Manage Server** permissions
* Click **Continue** and then **Authorize**

***

#### Step 3: Run Setup Command & Link Community

* Inside your Discord server, an **Administrator** must run:

```
/setup
```

* You’ll be prompted to enter your **ImperialCAD Community ID** and **API Key**
* These values are available in your CAD under **Settings → API**
* After submitting the values, ImperialBot will sync your Discord guild with your ImperialCAD community

***

#### Step 4: Configure Integration

Once linked, the invite button in your Admin Panel will disappear, and integration settings will appear.

You can now toggle:

* **Auto-Kick** → Automatically removes members from your community when they leave your Discord server, if their ImperialCAD account is verified.
* **Auto-Join** → Allows members who join your Discord server to automatically join your ImperialCAD community, If both are opted in.

***

### ⚠️ Troubleshooting

* **Bot won’t join?** Ensure you have *Manage Server* permissions in Discord
* **/setup not working?** Make sure the command is run by a *Discord Administrator*
* **Community not linking?** Double-check your **Community ID** and **API Key** from the API settings page

If issues persist, Contact support.