---
title: /unban
description: Unban a user by ID, username, or by selecting from search results.
---
## Overview

`/unban` removes a ban. You can search by user ID, full username, or partial username.

## Required Permissions

- **Ban Members**

## Options

| Option | Required | Description |
|--------|----------|-------------|
| `user` | Yes | User ID, full username, or partial username to search |
| `reason` | No | Reason for the unban |

## Behavior

- **Exact ID**: unbans that user immediately.
- **Exact username**: unbans that user immediately.
- **Partial match**: unbans directly if there's one match, otherwise shows a list and asks for the user ID.
- A confirmation step shows ban reason and case history before unbanning.
- The unbanned user receives a DM.
- A case is created and logged if a log channel is set.