docs/moderation/banning_users.md

# Banning Users

## Normal Ban
Use the `-ban` command to ban a user, regardless if they are in the server or not.

##### Legacy Command
```
-ban <UserID|UserMention|UserTag> [-d=DAYS] [Reason]
``` 

**Options**: 

- `-d`: Specify the how many days old messages to delete. Must be in range of 0-7. Default is - "Don't delete any".

##### Slash Command
```
/ban <User> [days] [reason]
```

##### Examples

```
-ban @Someone
-ban @Someone Spamming a lot
-ban @Someone -d 5 Spamming a lot
-ban 45643846466843
-ban 45643846466843 Spamming a lot
-ban 45643846466843 -d 7 Spamming a lot
```

## Temporary Ban
Temporarily ban users.

##### Legacy Command
```
-tempban <UserID|UserMention> <Time> [Reason]
``` 

##### Slash Command
```
/tempban <UserID> <Time> [days] [reason]
```

##### Examples

```
-tempban @Someone 1h
-tempban @Someone 30m Spamming a lot
-tempban 45643846466843 2m
-tempban 45643846466843 5d Spamming a lot
```

## Softban
Ban a user and unban immediately to remove messages from the user.

##### Legacy Command
```
-softban <UserID|UserMention> [-d=DAYS_OF_MESSAGE_DELETION] [Reason]
``` 

##### Slash Command
```
/softban <UserID> [-d=DAYS_OF_MESSAGE_DELETION] [days] [reason]
```

**Options**: 

- `-d`: Specify the how many days old messages to delete. Must be in range of 0-7. Default is `7`.

##### Examples

```
-tempban @Someone 1h
-tempban @Someone 30m Spamming a lot
-tempban 45643846466843 2m
-tempban 45643846466843 5d Spamming a lot
```

## Mass Ban
Use the `-massban` command to massban users.

##### Legacy Command
```
-massban <...UserIDs|UserMentions> [Reason]
``` 

##### Slash Command
```
/massban <...UserIDs> [days] [reason]
```

!!! note

    While using slash command, the IDs must be separated with spaces.

##### Examples

```
-massban 23626825621964 217216291276407
-massban 23626825621964 217216291276407 63876523582826865 Raiding the Server
-massban 23626825621964 217216291276407 @Someone 36362742746674467
```

## Unbanning
Use the `-unban` command to unban users.

##### Legacy Command
```
-unban <UserID>
``` 

##### Slash Command
```
/unban <UserID>
```

##### Examples

```
-unban 7485692162169
```
1	# Banning Users
2
3	## Normal Ban
4	Use the `-ban` command to ban a user, regardless if they are in the server or not.
5
6	##### Legacy Command
7	```
8	-ban <UserID\|UserMention\|UserTag> [-d=DAYS] [Reason]
9	```
10
11	Options:
12
13	- `-d`: Specify the how many days old messages to delete. Must be in range of 0-7. Default is - "Don't delete any".
14
15	##### Slash Command
16	```
17	/ban <User> [days] [reason]
18	```
19
20	##### Examples
21
22	```
23	-ban @Someone
24	-ban @Someone Spamming a lot
25	-ban @Someone -d 5 Spamming a lot
26	-ban 45643846466843
27	-ban 45643846466843 Spamming a lot
28	-ban 45643846466843 -d 7 Spamming a lot
29	```
30
31	## Temporary Ban
32	Temporarily ban users.
33
34	##### Legacy Command
35	```
36	-tempban <UserID\|UserMention> <Time> [Reason]
37	```
38
39	##### Slash Command
40	```
41	/tempban <UserID> <Time> [days] [reason]
42	```
43
44	##### Examples
45
46	```
47	-tempban @Someone 1h
48	-tempban @Someone 30m Spamming a lot
49	-tempban 45643846466843 2m
50	-tempban 45643846466843 5d Spamming a lot
51	```
52
53	## Softban
54	Ban a user and unban immediately to remove messages from the user.
55
56	##### Legacy Command
57	```
58	-softban <UserID\|UserMention> [-d=DAYS_OF_MESSAGE_DELETION] [Reason]
59	```
60
61	##### Slash Command
62	```
63	/softban <UserID> [-d=DAYS_OF_MESSAGE_DELETION] [days] [reason]
64	```
65
66	Options:
67
68	- `-d`: Specify the how many days old messages to delete. Must be in range of 0-7. Default is `7`.
69
70	##### Examples
71
72	```
73	-tempban @Someone 1h
74	-tempban @Someone 30m Spamming a lot
75	-tempban 45643846466843 2m
76	-tempban 45643846466843 5d Spamming a lot
77	```
78
79	## Mass Ban
80	Use the `-massban` command to massban users.
81
82	##### Legacy Command
83	```
84	-massban <...UserIDs\|UserMentions> [Reason]
85	```
86
87	##### Slash Command
88	```
89	/massban <...UserIDs> [days] [reason]
90	```
91
92	!!! note
93
94	While using slash command, the IDs must be separated with spaces.
95
96	##### Examples
97
98	```
99	-massban 23626825621964 217216291276407
100	-massban 23626825621964 217216291276407 63876523582826865 Raiding the Server
101	-massban 23626825621964 217216291276407 @Someone 36362742746674467
102	```
103
104	## Unbanning
105	Use the `-unban` command to unban users.
106
107	##### Legacy Command
108	```
109	-unban <UserID>
110	```
111
112	##### Slash Command
113	```
114	/unban <UserID>
115	```
116
117	##### Examples
118
119	```
120	-unban 7485692162169
121	```