> ## Documentation Index
> Fetch the complete documentation index at: https://docs.katofficial.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Whitelist Management

> Controls which guilds are allowed to use the bot

The Whitelist cog controls which guilds are allowed to use the bot and manages guild join applications.

## Commands

All commands are nested under `/whitelist`.

### `/whitelist guild`

| Subcommand | Description                                                                                        |
| ---------- | -------------------------------------------------------------------------------------------------- |
| `add`      | Adds a guild to the whitelist. Creates a permanent invite and stores metadata.                     |
| `remove`   | Removes a guild from the whitelist. Sends a leave notification and the bot leaves the guild.       |
| `list`     | Shows a paginated list of all whitelisted guilds.                                                  |
| `get`      | Displays stored and live information for a specific whitelisted guild, including change detection. |
| `sync`     | Leaves all guilds that are not on the whitelist and purges orphaned database records.              |

### `/whitelist applicationgate`

Configures the join application gate for a guild. When enabled, new members must complete an application before gaining full access.

### `/whitelist bot`

Guild owner only. Used to whitelist bots on your server. This is part of Sentry's Anti-Nuke system.

## Permission Requirements

All whitelist commands require bot owner/guild permission.