/role config set
Description
Stores bot-specific settings for a Discord role. A name schema controls nicknames, while a role action controls how the role is applied or removed when users are synchronized. If neither optional argument is supplied, the command displays the role's current configuration instead of changing it.
Arguments
Name | Type | Description | Optional? |
|---|---|---|---|
| Role | Role to configure. | ❌ No |
| String | Nickname schema to use when this role determines a member's nickname. | ✅ Yes |
| Enumeration | When the bot should apply or remove the role based on whether a member is verified. | ✅ Yes |
Examples
Set a role action
/role config set role: @Verified role-action: Apply And Remove When Verified
View the current configuration
/role config set role: @Verified
See Also
/role config reset: clear a role's name schema.
Role Management: understand when role configuration is evaluated.
28 August 2026