Can Guild Tags (Server Profile Tags) Be Detected by a Discord Bot?

[CharlesNaig]

Hi devs!

I'm currently developing a feature for my bot where members receive a role automatically when they use a Guild Tag (aka Server Tag) — the 4-character badge you set in your Server Profile that shows up next to your name in the member list.

I’ve tried all of the following approaches:

• ✅ guildMemberUpdate (nickname changes, roles, etc.)

• ✅ userUpdate (globalName, username, avatar)

• ✅ raw events (deep packet checking on GUILD_MEMBER_UPDATE)

• ✅ Manual interval checks against member.displayName, nickname, user.username, globalName

However, none of them provide access to the Guild Tag field or anything resembling it.
It appears to be purely a client-side badge that isn't included in API payloads or caches.

💬 The mystery:
I’ve encountered servers where this feature works — users set their Guild Tag (badge), and a bot automatically gives them a role, even without changing their nickname or username.

So I’m wondering:

• 🔍 Is there any undocumented way this tag is exposed to bots?

• 🤔 Could Discord expose the Guild Tag in guildMember or user objects in the future?

• 🧪 Are these servers possibly using modded clients or selfbots (not bot API-based)?

• ✅ Would love clarity on whether Guild Tags are accessible to bots, or if what we’re seeing is simply nickname-based simulation (which I’ve already implemented).

Thanks in advance for any clarification or roadmap insight 🙏

ATTACHMENTS VIDEO:

2025-06-26.04-17-55.mp4

2025-06-26.04-17-55.mp4

[Jiralite]

This feature is not documented by Discord. It currently exists in the API, however. It will be added to discord.js once documented.

This appears to be the upstream pull request: discord/discord-api-docs#6836
Feel free to subscribe to it.

[sw3do]

Discord Guild Member Update Implementation

Current Status

Discord hasn't released an official update for this feature yet, but there's a workaround available.

Implementation Method

You can use the following approach to listen for guild member updates:

client.ws.on(GatewayDispatchEvents.GuildMemberUpdate, async (data) => {
  console.log(data)
});

Example Repositories

1. sw3do/discord-tag-role-bot

Repository: https://github.com/sw3do/discord-tag-role-bot

A Discord bot that automatically assigns and removes roles based on user guild tags. When a user's primary guild tag matches your configured tag, they automatically receive a specified role.

2. Androz2091/server-tags-discord-bot

Repository: https://github.com/Androz2091/server-tags-discord-bot

Assign a role and send a reward message when your server tag is added by someone!

Technical Implementation

Both repositories demonstrate different approaches to handling guild member updates and role management based on server tags. The key is using Discord's raw gateway events to monitor real-time profile changes.

[CharlesNaig]

Thank you for the response will try this right away! 💖

[sw3do]

You are welcome. Im waiting your response! <3

[CharlesNaig]

solution works thank you!

[sw3do]

You are welcome :)