> Full Clanzy docs index (for AI agents): https://clanzy.app/en/llms.txt · HTML page: https://clanzy.app/en/docs/troubleshooting/missing-permissions

# Clanzy says Missing Permissions

/setup says Could not finish this step: Missing Permissions, or room panel buttons fail? Give Clanzy back the permissions it needs at server and channel level.

What you see: "Could not finish this step: Missing Permissions"

## Symptom

- After `/setup all` (or `/setup welcome`, `/setup onboarding`, `/setup voice`), the summary has a ⚠️ line: **Could not finish this step: Missing Permissions** or **Missing Access**.
- A room panel button or a `/voice` command replies **Something went wrong. Please try again later.**
- Welcomes aren't posted or temp rooms aren't created even though the bot is online.

## Causes

1. **The Clanzy role lost permissions** after it was added, or it was added through a link that asked for fewer.
2. **A channel or category denies Clanzy** (or denies @everyone with no exception for Clanzy). Channel overrides win over server permissions.
3. **The role to assign sits above Clanzy's role.** That one has its own page: [Clanzy's role is too low](https://clanzy.app/en/docs/troubleshooting/role-too-low).

## Fix

1. Restore server-level permissions. Fastest: open [/invite](https://clanzy.app/en/invite), pick the same server and confirm. Or by hand: **Server Settings** → **Roles** → **Clanzy** → **Permissions**, and turn on:

| Permission | Used for |
| --- | --- |
| **Manage Channels** | Creating the welcome channel, category, hub and temp rooms, deleting empty rooms |
| **Manage Roles** | Creating game roles, adding and removing roles, locking, hiding and kicking in temp rooms |
| **Move Members** | Moving you into your new room, kicking people out of it |
| **View Channels**, **Connect** | Seeing the hub and the temp rooms |
| **Send Messages**, **Embed Links**, **Read Message History** | Posting the welcome card and the room control panel |
| **Timeout Members**, **Kick Members**, **Ban Members**, **Manage Messages** | [Moderation](https://clanzy.app/en/docs/moderation) and [anti-spam](https://clanzy.app/en/docs/automod) |
| **View Audit Log** | Showing who deleted a message or changed a role in the [server logs](https://clanzy.app/en/docs/logs) |

2. Check overrides on the channels involved: right-click (mobile: long-press) the welcome channel, the **🔊 Temp rooms** category and the **➕ Create a room** channel → **Edit Channel** → **Permissions**. If Clanzy or @everyone has a red X on anything in the table, add the **Clanzy** role and give it a green check.
3. Run `/setup all` again. It reuses what already exists, so re-running is safe ([details](https://clanzy.app/en/docs/getting-started/setup-all)).

> [!TIP]
> Those permissions are all Clanzy needs. Don't hand it **Administrator**. Each one is explained on [Clanzy's permissions](https://clanzy.app/en/docs/getting-started/permissions).

> [!NOTE]
> Servers that added Clanzy before 20 Nov 2026 lack the mod permissions. Open **Moderation** in the dashboard and press **Re-authorize**; settings are kept.

## Still stuck?

Get in touch through [support](https://clanzy.app/en/docs/support) with a screenshot of the `/setup` summary. Bot health is on [/status](https://clanzy.app/en/status).

## FAQ

### Does Clanzy need Administrator?

No. It needs Manage Channels, Manage Roles, Move Members, View Channels, Send Messages, Embed Links, Read Message History and Connect.

### What's the quickest way to restore its permissions?

Open /invite and add Clanzy to the same server again. Discord updates the Clanzy role's permissions and your settings stay. Then check that no channel or category denies the Clanzy role.

### What's the difference between Missing Access and Missing Permissions?

Missing Access usually means Clanzy can't see the channel at all. Missing Permissions means it sees the channel but lacks one specific permission, such as Manage Channels or Manage Roles.

Updated: 2026-11-20
