ButtonRoles

Here is everything you need to know about ButtonRoles

What are ButtonRoles?

It's pretty simple. You click a button and the bot gives or removes a role from you.

Number limitations
- Only up to 25 ButtonRoles per message
- Only on the bots messages
- Only up to 5 roles in one ButtonRole
- Role names being set up cant exceed 50 characters
Label limitations
- All emojis are valid
- Label character limit is 80

Role(s) have to be below the bots highest role
The bot has to have MANAGE_ROLES , EMBED_LINKS andMANAGE_MESSAGES permissions
Either label or emoji has to be existing
With 2 or more roles a custom label is required

Type out /buttonrole create
Select the type you want to use Toggle adds and removes roles (when you have the role it removes it and vice versa Add only adds roles but doesn't remove them Remove only removes roles but doesn't add them
Select a role Make sure all the requirements mentioned above are met
Select any type of text based channels TextChannels, NewsChannels and Threads work for this
Write a nice description This will be displayed as the main field in the embed when above the ButtonRole OPTIONAL:
Select a title of your embed
Select a color for your embed If none has been chosen the default color will be used
Select a label If you don't want a label just send pass none and the label will be empty Just be sure to meet the label requirements above
Select an emoji If you don't want an emoji just pass none and the emoji will be empty
Select a style of the button
Select whether the member should be notified about the role change or not
Select any additional roles When the button is clicked the bot will process all the roles (e.g. remove every role set up)
Select a role you want the button to be restricted to. Only members with the selected role can claim or remove a role.

When you're done your command should look similar to this:

Last updated 3 years ago

Was this helpful?