Skip to main content
Guild Tag allows you to automatically detect when members set your server as their primary guild (Discord’s Server Identity feature) and reward them with roles. When they switch to another server or remove the tag, the roles are automatically removed.
Required Permission: Admin Access or higher — Server Owner, Extra Owner, Trusted User, or Administrator with a role above the bot can use these commands.
Premium Feature: This module requires an active Premium subscription. If the server’s premium expires, the guild tag system will be automatically disabled.

​
Setting Up

Follow these steps to configure the guild tag system for your server.
1

Run the Setup Command

Provide the award role(s), the log channel, and an optional reward message.
2

Verify the Configuration

Use the show command to confirm everything is set correctly.
3

Test It

Send a test message to make sure the output looks right.
You can only assign up to 3 award roles. Roles with dangerous permissions (Administrator, Manage Server, etc.) are blocked and cannot be used as award roles.

​
Commands

​
Configuration

​
Role Management

​
Controls

​
Customizing Messages

The tag message is fully customizable and supports both dynamic variables and custom embeds. When a member equips your server as their primary guild, the bot sends the configured message to the log channel with all variables parsed into real data.

​
Using Variables

You can dynamically insert information like the user’s name or server details. Refer to the Variables reference for the full list. Available contexts: Server, Channel, User, Author, Target

​
Using Custom Embeds

Design a rich embed using the interactive embed builder, then attach it to your message with the {embed:name} syntax.
1

Create the Embed

Use the dropdown menu to customize title, description, color, images, and variables.
2

Attach to Message

The {embed:name} placeholder is invisible in the final output. The bot strips it from the text and attaches the rich embed below the message. Variables placed inside the embed builder will also parse correctly.

​
Limitations

  • Guild Tag detection relies on Discord’s Server Identity feature. If a member has not opted into Server Identity, their tag will not be detected.
  • If the configured log channel is deleted, messages will silently fail until a new channel is set.
  • The .guildtag sync command has a 60 second cooldown per server to prevent abuse.