Kick
Overview
The /kick command removes a member from the server. Unlike banning, kicked users can rejoin using an invite link. This is useful for temporary removal without the permanence of a ban.
Command Details
Permissions Required
User:
KICK_MEMBERSpermissionBot:
KICK_MEMBERSpermission
Command Syntax
/kick member:<@member> reason:<text>Parameters
member
User
✅ Yes
The member to kick from the server
reason
String
✅ Yes
The reason for kicking the member
Features
1. Temporary Removal
User is removed from the server
Can rejoin with any valid invite link
Useful for "cooling off" periods
Less severe than banning
2. Role Hierarchy Protection
Moderators cannot kick members with equal or higher roles
Prevents abuse of moderator powers
Maintains proper permission structure
3. DM Notifications
Kicked users receive a DM with:
Server name they were kicked from
Reason for the kick
Server invite link to rejoin
4. Audit Logging
Logs action to audit channel
Records in moderation history database
Tracks: moderator, target, reason, timestamp
5. Moderation History
Adds entry to user's moderation record
Can be viewed with
/user-infoHelps track repeat offenders
Usage Examples
Example 1: Basic Kick
Removes the user for spamming. They can rejoin if they promise to follow rules.
Example 2: Rule Violation
Kick for accumulated minor violations.
Example 3: Cooling Off Period
Temporary removal to de-escalate situation.
How It Works
Permission Validation:
Checks moderator has
KICK_MEMBERSpermissionVerifies moderator's role is higher than target's
Ensures bot can kick the target
DM Notification:
Sends DM explaining the kick
Includes reason and server invite link
Failure to DM is logged but kick proceeds
Execute Kick:
Removes member from server
Discord API kick action with reason
Database Updates:
Adds entry to moderation history
Records moderator, reason, timestamp
Marked as type "kick"
Audit Logging:
Posts to configured audit channel
Formatted embed with details
Available for moderator review
Kick vs Ban
Removal
Yes
Yes
Can Rejoin
Yes (with invite)
No (unless unbanned)
Duration
Instant (can immediately rejoin)
Permanent or temporary
Severity
Lower
Higher
Use Case
Minor offenses, cooling off
Serious violations, repeat offenders
Error Handling
Equal/Higher Role: "You cannot kick a member with equal or higher role than yours."
Not Kickable: "I do not have permission to kick this member."
DM Failure: Logged, but kick proceeds
General Error: "Unable to kick member."
Related Commands
Ban - Permanently or temporarily ban
Mute - Timeout without removal
Warn - Issue warning
Unban - Reverse a ban
User Info - View moderation history
Configuration
Configure in config.json:
Best Practices
Use for minor offenses - Kicks are less severe than bans
Provide clear reasons - Helps users understand what they did wrong
Give chance to improve - Kicks allow users to come back reformed
Document the action - Always include detailed reason
Consider alternatives - Warnings or mutes might be sufficient
Track repeat offenders - Use
/user-infoto see history
When to Use Kick
Good Use Cases:
First-time rule violations
Users who need a "wake-up call"
De-escalating heated situations
Giving users a chance to cool off
When a warning isn't enough but ban is too harsh
Consider Ban Instead:
Repeat offenders with multiple kicks
Serious ToS violations
Malicious behavior (raiding, doxxing)
Users unlikely to improve
Tips
Kicks are temporary - users can rejoin immediately
Keep your invite link updated in configuration
Explain rules clearly when users rejoin
Consider adding a "kicked members" role on rejoin to track
Use with warnings as progressive discipline
Review user history before re-kicking
Last updated
Was this helpful?