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

  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.