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.
.guildtag setup @Repper #tag-log Thanks for repping us, {user}!
2

Verify the Configuration

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

Test It

Send a test message to make sure the output looks right.
.guildtag test
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

CommandDescription
.guildtag channel <channel>Updates the log channel for tag messages
.guildtag message <text>Sets the reward message
.guildtag showShows the current configuration
.guildtag resetDeletes the entire configuration

​
Role Management

CommandDescription
.guildtag role add <role>Adds an award role (max 3)
.guildtag role remove <role>Removes an award role

​
Controls

CommandDescription
.guildtag enableEnables the guild tag system
.guildtag disableDisables the guild tag system
.guildtag testSends a test tag message to the configured channel
.guildtag syncManually syncs tag roles for all members (60s cooldown)

​
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 
.guildtag message {user} just equipped {servername} as their primary guild!

​
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

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

Attach to Message

.guildtag message Welcome to the crew, {user}! {embed:tag_card}
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.