Skip to main content
Moderation commands help server administrators and moderators manage their community effectively. These commands require specific permissions for both the user and the bot.
Moderation commands can only be used by members with appropriate permissions. Make sure Yato has the required permissions in your server.

Ban

Ban a user from the server permanently.

Syntax

/ban user:<user> [reason:"optional reason"]

Parameters

user
User
required
The user to ban from the server
reason
String
Reason for banning the user (will be shown in audit logs)

Required permissions

User permission

BAN_MEMBERS

Bot permission

BAN_MEMBERS

Examples

/ban user:@baduser

Notes

  • You cannot ban yourself
  • The bot cannot ban users with higher or equal roles
  • The ban reason will include the moderator’s username
  • If no reason is provided, it will show “No reason provided by [username]“

Kick

Kick a user from the server (they can rejoin with an invite).

Syntax

/kick user:<user> [reason:"optional reason"]

Parameters

user
User
required
The user to kick from the server
reason
String
Reason for kicking the user (will be shown in audit logs)

Required permissions

User permission

KICK_MEMBERS

Bot permission

KICK_MEMBERS

Examples

/kick user:@troublemaker

Notes

  • You cannot kick yourself
  • The bot cannot kick users with higher or equal roles
  • The kick reason will include the moderator’s username
  • If no reason is provided, it will show “No reason provided by [username]“

Best practices

Including a reason with moderation actions helps maintain transparency and creates a clear moderation history in your server’s audit logs.
Ensure Yato’s role is positioned higher than the roles of users you want to moderate. The bot cannot take action against users with equal or higher roles.
Only grant moderation permissions to trusted members. These commands can significantly impact your server.

Troubleshooting

If you receive an error that the bot cannot ban/kick a member, check:
  • Yato has the required permissions
  • Yato’s role is higher than the target user’s highest role
  • You have the required permissions to use the command

Need help?

For additional support with moderation commands, join the Yato Support Server.

Build docs developers (and LLMs) love