Guild Tag Roles Module

Automatically grant a Discord role to members who display your server’s Primary Guild tag (server badge): set-and-forget guild tag roles.

Overview

Discord lets members equip a server tag on their profile. When someone shows your server's tag, Lio can grant a reward role.

When they remove the tag, the role can be removed automatically. Great for loyalty perks without manual checks.

Setup

  1. Enable Guild Tag Roles in Modules.
  2. Pick the reward role to grant while the tag is equipped.
  3. Optional: notification channel when someone earns the role.
  4. Toggle Check on member join to scan existing tag holders when they join.
  5. Save: Lio syncs on join and when tag status changes.

Key settings

  • Reward role: granted while the member's equipped guild tag matches this server.
  • Remove role when tag is removed: keeps the reward tied to actually wearing the tag.
  • Check on member join: assigns the role immediately if they already wear your tag.
  • Notification channel: optional public message when someone earns the role.

Usage

Fully automatic: members equip or remove the server tag in Discord; Lio handles the role.

No slash commands or panel required.

Troubleshooting

  • Role not applied → bot role must sit above the reward role in the role list.
  • Tag equipped but no role → Check on member join enabled? ask member to re-equip the tag once.
  • Role stays after tag removed → enable Remove role when tag is removed and save.