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	rakinar2	575	---
2	rakinar2	626	title: "Command: `ban`"
3	rakinar2	575	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			```