Reaction Roles

The Reaction Roles system lets members self-assign roles through interactive panels.

Basic Button Panel Example

ReactionRoles:
  Enabled: true

  ServerRoles:
    type: "BUTTON"
    resetReacts: true
    ChannelID: "CHANNEL_ID"
    Embed:
      Title: "**Choose Your Roles!**"
      Description:
        - "Click a button below to get or remove a role."
      Color: "#1769FF"
    Reactions:
      - Name: "Announcements"
        Emoji: "📢"
        Style: "Primary"
        RoleID: "ROLE_ID"
      - Name: "Events"
        Emoji: "🎉"
        Style: "Success"
        RoleID: "ROLE_ID"

👉 Replace CHANNEL_ID with the channel you want the panel in. 👉 Replace each ROLE_ID with real IDs.

Quick Setup Examples

1️⃣ Basic Server Roles (Button Panel)

ReactionRoles:
  Enabled: true

  ServerRoles:
    type: "BUTTON"
    resetReacts: true
    ChannelID: "CHANNEL_ID"
    Embed:
      Title: "📢 Server Roles"
      Description:
        - "Choose which notifications you’d like."
      Color: "#1769FF"
    Reactions:
      - Name: "Announcements"
        Emoji: "📢"
        Style: "Primary"
        RoleID: "ROLE_ID"
      - Name: "Events"
        Emoji: "🎉"
        Style: "Success"
        RoleID: "ROLE_ID"

2️⃣ Pronoun Roles (Select Menu Panel)

ReactionRoles:
  Enabled: true

  Pronouns:
    type: "SELECT"
    resetReacts: false
    ChannelID: "CHANNEL_ID"
    Embed:
      Title: "🌈 Pronoun Roles"
      Description:
        - "Pick the pronouns that fit you."
      Color: "#FFA500"
    Reactions:
      - Name: "He/Him"
        Emoji: "👨"
        RoleID: "ROLE_ID"
      - Name: "She/Her"
        Emoji: "👩"
        RoleID: "ROLE_ID"
      - Name: "They/Them"
        Emoji: "⚧️"
        RoleID: "ROLE_ID"

3️⃣ Age/Region Verification (Reaction Panel)

ReactionRoles:
  Enabled: true

  Verification:
    type: "REACT"
    resetReacts: true
    ChannelID: "CHANNEL_ID"
    Embed:
      Title: "✅ Verification"
      Description:
        - "React below to verify and unlock the server."
      Color: "#00FF00"
    Reactions:
      - Name: "18+"
        Emoji: "🔞"
        RoleID: "ROLE_ID"
      - Name: "Under 18"
        Emoji: "🍼"
        RoleID: "ROLE_ID"
      - Name: "North America"
        Emoji: "🌎"
        RoleID: "ROLE_ID"
      - Name: "Europe"
        Emoji: "🌍"
        RoleID: "ROLE_ID"
      - Name: "Asia"
        Emoji: "🌏"
        RoleID: "ROLE_ID"

How to post the panel

  • To post a panel you will need to restart the bot.

  • Once restarted the panel will appear in the channel.

Troubleshooting

❌ Buttons/Reactions not working

  • Ensure ReactionRoles.Enabled = true

  • Bot needs Manage Roles permission

  • Bot’s role must be above roles being assigned

❌ Panel not appearing

  • Channel ID is incorrect

  • Bot hasn't been restarted

❌ Roles not assigned

  • Replace all ROLE_IDs with actual IDs

  • Ensure that the bots role is higher than the assigned role

❌ Multiple panels interfering

  • Each panel needs a unique name

PreviousInvite RolesNextModeration

Last updated