Community
!role matching
Preview a role operation for members matching role filters.
abhi.gg
Public surface
operations context
Dashboardready
Docslinked
Statusclear
$status public-checkAudience
Server Admin
Product area
Community
Aliases
None
How to use
Supported invocation
!role matching <action> <role> [required_roles] [excluded_roles] [include_bots] [reason]action Required
The action for this command.
role Required
The role for this command.
required_roles Optional
The required roles for this command.
excluded_roles Optional
The excluded roles for this command.
include_bots Optional
The include bots for this command.
reason Optional
The reason for this command.
Access
What the server must allow
- Discord permission: Manage Roles
- Availability depends on the server's current service access.
- The related module must be enabled.
- Requires Manage Roles.
Expected behavior
Success and unavailable states
When available
The command returns the documented result for !role matching: Preview a role operation for members matching role filters.
When unavailable
- If !role matching cannot be applied, Abhi explains the missing server permission, module, plan, or service state.
- No community setting or member state is partially changed when validation fails.
- A temporary failure for !role matching is reported without silently claiming success and can be retried safely.