> Full Clanzy docs index (for AI agents): https://clanzy.app/en/llms.txt · HTML page: https://clanzy.app/en/docs/commands/unban

# /unban

Clanzy's /unban command: Lift a ban. Syntax, who can use it, bot permissions, examples and common errors.

Lift a ban. Banned people are not in the server, so paste their ID (shown in the cases list in the dashboard).

## Syntax

```
/unban user:<user> reason:<reason>
```

Type `/` in a server channel, pick the command from the list and fill in the fields Discord shows.

## Options

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `user` | member | Yes | Who to unban (paste their ID) |
| `reason` | text | No | Reason (sent to the member and kept in the case) (up to 500 characters) |

## Who can use it

- **Members:** Mods with Ban Members. Discord hides the command from members without it.
- **Clanzy needs:** Ban Members.
- **Feature:** [Moderation](https://clanzy.app/en/docs/moderation)

See [permissions and who can use what](https://clanzy.app/en/docs/getting-started/permissions) to change who sees commands in Discord.

## Examples

| You type | Clanzy does |
| --- | --- |
| `/unban user:123456789012345678 reason:Đã xin lỗi` | ✅ They can rejoin with an invite. Paste their ID into the user field. |

## In the dashboard

The related settings are in the [dashboard](https://app.clanzy.app/?open=moderation): pick your server and the section opens.

## Errors you may see

| Clanzy says | What it means and the fix |
| --- | --- |
| You need the **Ban Members** permission to use this command. | This command needs its own permission: Kick Members for /kick, Ban Members for /ban and /unban, Manage Messages for /purge. Ask an admin to grant it to your role. [More](https://clanzy.app/en/docs/moderation) |
| That user is not banned. | The ID you pasted is not in the server's ban list. Check the ID in the cases list in the dashboard. |

## Related commands

- [`/ban`](https://clanzy.app/en/docs/commands/ban): Ban someone from the server
- [`/cases`](https://clanzy.app/en/docs/commands/cases): A member's moderation history
- All commands: [command list](https://clanzy.app/en/docs/commands)

Updated: 2026-11-20
