moderation/ban/page.mdx

---
title: "Command: `ban`"
short_name: ban
---

import Modes from "@/components/MDX/Modes";

# `ban`

Bans a user from the server. Doesn't matter if the user is in the server or not.
If the user is in the server, they will receive a DM notice from the bot telling them that they were banned, with the given reason.

### Syntax

```
-ban <user_mention|user_id> [reason]
-ban <user_mention|user_id> [message_deletion_timeframe=0s] [reason]
```

### Required Permissions

`ADMINISTRATOR` or `BAN_MEMBERS`

### Modes

<Modes modes={["legacy", "interaction"]} />

### Examples

```
-ban @Someone Violating rules
-ban 84465685652367452 7d Violating rules
```
1	---
2	title: "Command: `ban`"
3	short_name: ban
4	---
5
6	import Modes from "@/components/MDX/Modes";
7
8	# `ban`
9
10	Bans a user from the server. Doesn't matter if the user is in the server or not.
11	If the user is in the server, they will receive a DM notice from the bot telling them that they were banned, with the given reason.
12
13	### Syntax
14
15	```
16	-ban <user_mention\|user_id> [reason]
17	-ban <user_mention\|user_id> [message_deletion_timeframe=0s] [reason]
18	```
19
20	### Required Permissions
21
22	`ADMINISTRATOR` or `BAN_MEMBERS`
23
24	### Modes
25
26	<Modes modes={["legacy", "interaction"]} />
27
28	### Examples
29
30	```
31	-ban @Someone Violating rules
32	-ban 84465685652367452 7d Violating rules
33	```