Guild Tag Roles Module
Reward members who display your Discord server tag (Primary Guild badge) with an automatic role.
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
- Enable Guild Tag Roles in Modules.
- Pick the reward role to grant while the tag is equipped.
- Optional: notification channel when someone earns the role.
- Toggle Check on member join to scan existing tag holders when they join.
- 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.