# Discord setup

> Linking a Discord server, the channels Klash creates, bot identity per tournament, and the host-your-own-server-or-use-Klash's-shared-guild choice.

Klash runs on Discord. You pick where the tournament lives - your own server or the shared Klash community server - authorize the bot, and the channel structure builds itself from there.

The four channels Klash creates under the tournament's category.

## Where to host: your server or Klash's

The Discord server picker on the Create form gives you two options, and either works fully. Pick **your own server** if you already run a community there or want full control over moderation and side channels. The bot drops a category named after your tournament into your existing server and ignores everything outside it. Pick the **Klash.gg community server** if you don't have a server, don't want to maintain one, or are running a one-off event and would rather not deal with server management. Both options give you the same channels, the same KARA, and the same Dock.

## Linking a server

If you're using your own server, the picker lists Discord servers where you have admin rights. Authorize the bot once per server - that authorization is remembered for every future event on the same server, so a recurring weekly only needs this step once. If you're using the Klash community server, there's nothing to authorize; you're set.

## What Klash creates

For every tournament, Klash creates a category named `<your tournament title> - Klash.gg` with four channels inside it. The `🛠️│organizers` channel is private - you and your moderators see it, players don't, and tournament-level notifications land here. The event announcement channel (default `📢│<game>-event`) is read-only for players and spectators; tournament updates, registration confirmations, bracket publications, and start announcements post here. When you mark the tournament Completed, the channel renames by appending `-closed`. The `🎮│players` channel is a chat channel for registered players. The spectator channel (default `🎉│spectators`) is open to anyone in the server and renames to `🎉│after-party` at Completed.

Per-set channels appear under the same category as each match starts, named with a `🆚│set-` prefix. They clean themselves up about ten minutes after each set finishes during Live.

At Finalized, all Klash channels (the four mains and any remaining set channels), the category, and the roles Klash created are removed from your server entirely. Klash keeps an archive of the chat, but it's no longer browseable on Discord. Save anything you want to keep before you Finalize.

You can rename the default channel names from the Discord panel on the tournament page if your server has conflicting names or you prefer different conventions.

## Bot identity per tournament

The bot can show a custom nickname and avatar for each tournament you run on the same server. Useful when two events are running on one server and you want them to feel distinct in the sidebar. Both nickname and avatar live on the Discord panel; changes take effect immediately.

## Permissions Klash needs

When you authorize the bot, Discord asks for a set of permissions. Klash needs Manage Channels to create the tournament's category and the channels under it, Manage Roles to create the organizer, moderator, and player roles tied to the tournament, and Send Messages plus Embed Links to post announcements, results graphics, and bracket cards.

If a permission is missing or something is blocking the bot from posting, the Discord panel on the tournament page shows a warning.

If the bot can't post at any point, ping Klash support in Discord. Don't try to debug it yourself mid-event; support can see what's blocking it and resolve it without touching your bracket.

## KARA in set channels

Once a set channel is created, [KARA](./kara) joins it automatically. KARA answers routine player questions, posts the result-report buttons, and pings you or a moderator when something needs human judgment. For the player-side experience, see [player check-in](/docs/player/checking-in).

## FAQ

### Should I use my own Discord server or Klash's shared guild?

Either works. Use your own server if you already run a community there; use the Klash community server if you don't want to manage one. Both get the same channels, KARA, and Dock.

### The bot can't post in one of my channels - what's wrong?

Ping Klash support in Discord. The fix is on their side; don't burn time guessing while your event is running.

### Can I use an existing Discord server that already has other channels and roles?

Yes. Klash creates its category alongside your existing structure and doesn't touch anything outside it. Your general channels, announcements, and roles stay as they are.

### What happens to the auto-created channels after my tournament ends?

At Completed, the event channel renames with a `-closed` suffix and the spectator channel becomes `🎉│after-party`. Per-set channels are already gone by then. At Finalized, all tournament channels, the category, and the Klash-created roles are removed from your server. Save anything you want to keep before you Finalize.

### Can the bot show different names in different tournaments on the same server?

Yes. Nickname and avatar are per-tournament, set on the Discord panel of each event.

Source: https://klash.gg/docs/organizer/discord-setup
