Document user guild tags #6836

hammerdr · 2024-05-02T20:41:43Z

Guilds can adopt a server tag and allow users to adopt the guild's tag as their own. This tag is displayed in
the client next to their name.

This documents the server tags that might come down on the user object.

To see the specific tasks where the Asana app for GitHub is being used, see below:
- https://app.asana.com/0/0/1210467268571409
- https://app.asana.com/0/0/1210619041517332

docs/resources/User.md

cobaltt7 · 2024-05-03T02:17:38Z

Will there be an option for server owners to disable showing clan tags in their server? I feel like messages would get quite cluttered otherwise, especially for servers completely unrelated to gaming.

Lulalaby · 2024-05-03T02:24:15Z

Agreed, that should be definitely kept in mind.
A message author can currently have

their name
a role icon
a app / verified app tag
a linked role badge

Additionally, to have a clan badge next to it would fill the whole author line probably at some point.

MinnDevelopment · 2024-05-13T19:40:58Z

Why was this naming convention approved? This is going to cause a ton of confusion for every new developer. Now we have two naming discrepancies that are even conflicting. Server -> Guild and Guild -> Clan. I'm really disappointed in this decision and dread the amount of confusion this will cause.

sumeetv · 2024-05-14T23:55:27Z

Hey everyone, I'm one of the engineering leads of the team testing this feature out. We understand the confusion around guilds and server terminology. This is just an experiment at this time. If we decide to roll this out more broadly after the experiment concludes, we intend to come up with a better name that will be consistent across our Developer API and how we refer to it in the product. We know this might cause some confusion while the experiment is live and intend to clean things up soon. Thanks!

MCausc78 · 2024-05-19T17:24:43Z

curious, but why some fields in user.clan in interaction.resolved.messages[x] and GET /users/{user.id} are null? Happens with some users

{
  "type": 0,
  "tts": false,
  "timestamp": "2024-05-19T17:21:27.550000+00:00",
  "pinned": false,
  "mentions": [],
  "mention_roles": [],
  "mention_everyone": false,
  "id": "1241802919326646283",
  "flags": 0,
  "embeds": [],
  "edited_timestamp": null,
  "content": "haven't seen you in a while",
  "components": [],
  "channel_id": "1241787241014104136",
  "author": {
    "username": "pukima",
    "public_flags": 4194432,
    "id": "751092600890458203",
    "global_name": "Pukima",
    "discriminator": "0",
    "clan": {
      "tag": null,
      "identity_guild_id": null,
      "identity_enabled": false,
      "badge": null
    },
    "avatar_decoration_data": {
      "sku_id": "1144307629225672846",
      "asset": "a_d72066b8cecbadd9fc951913ebcc384f"
    },
    "avatar": "b7e2f5461e61512674abc06c3d0264b7"
  },
  "attachments": []
}

devsnek · 2024-05-19T21:21:34Z

docs/resources/User.md

@@ -59,6 +60,12 @@ There are other rules and restrictions not shared here for the sake of spam and
  "accent_color": 16711680,
  "premium_type": 1,
  "public_flags": 64
+  "clan": {
+    "identity_guild_id": "1234647491267808778",
+    "identity_enabled": true,


if they've disabled identity shouldn't this whole clan object just not be serialized?

Hurming · 2025-05-02T06:19:45Z

@devsnek when this will add?

ManHatos · 2025-05-02T10:25:52Z

https://support.discord.com/hc/en-us/articles/23187611406999-Guilds-FAQ

Guilds was an experimental feature available to a limited number of users. At this time, we’ve closed out the Guilds experiment and this feature is no longer available. Certain features that were part of the Guilds experience may still be available as standalone experiments.

Dovahseod · 2025-05-26T00:34:42Z

https://support.discord.com/hc/en-us/articles/23187611406999-Guilds-FAQ

Guilds was an experimental feature available to a limited number of users. At this time, we’ve closed out the Guilds experiment and this feature is no longer available. Certain features that were part of the Guilds experience may still be available as standalone experiments.

That aged like fine milk

TwilightZebby · 2025-05-26T05:04:05Z

https://support.discord.com/hc/en-us/articles/23187611406999-Guilds-FAQ

Guilds was an experimental feature available to a limited number of users. At this time, we’ve closed out the Guilds experiment and this feature is no longer available. Certain features that were part of the Guilds experience may still be available as standalone experiments.

That aged like fine milk

It's not wrong though.

Membership Applications (part of Guilds experiment) was released separately as it's own feature (in Server Settings -> Access -> Apply to Join)
Tags are also part of a new experiment as their own feature (as a new Boost Perk), now called Server Tags instead of Guild Tags

Gaming Guilds themselves haven't returned (I assume fully scrapped); and their enforced 200-member limit you can just manually recreate yourself easily via revoking Create Invite permission & deleting all Invites when your Server hits that member count.

Lulalaby

Leaving this here as updated information for the skill_tree feature "Server Tag".
tl;dr: primary_guild is the new field; clan is deprecated but most likely still in the api for backwards compatibility
gif is not possible for the badge

Note

The table formatting won't fit anymore because it's a web review

Cheers!

docs/resources/User.md

docs/Reference.md

blord0 · 2025-06-22T22:53:33Z

Any update on when this is going to get merged? Just as primary_guilds are released publicly now to everyone

docs/resources/User.md

docs/resources/user.mdx

anthonydiscord

Looks great!

ooliver1 · 2025-06-25T22:10:08Z

docs/resources/user.mdx

+| Field             | Type       | Description                                                   |
+|-------------------|------------|---------------------------------------------------------------|
+| identity_guild_id | ?snowflake | the id of the user's primary guild                            |
+| identity_enabled  | ?boolean   | whether the user is displaying the primary guild's server tag |


I really do think the behaviour of this being null meaning a new identity hasn't been affirmed should be documented. It is very unclear otherwise.

ooliver1 · 2025-06-25T22:14:26Z

docs/reference.mdx

@@ -353,6 +353,7 @@ Discord uses ids and hashes to render images in the client. These hashes can be
 | Role Icon                   | role-icons/[role_id](/docs/topics/permissions#role-object)/[role_icon](/docs/topics/permissions#role-object).png                                                                                                                                                                                                                                                              | PNG, JPEG, WebP            |
 | Guild Scheduled Event Cover | guild-events/[scheduled_event_id](/docs/resources/guild-scheduled-event#guild-scheduled-event-object)/[scheduled_event_cover_image](/docs/resources/guild-scheduled-event#guild-scheduled-event-object).png                                                                                                                                                                   | PNG, JPEG, WebP            |
 | Guild Member Banner         | guilds/[guild_id](/docs/resources/guild#guild-object)/users/[user_id](/docs/resources/user#user-object)/banners/[member_banner](/docs/resources/guild#guild-member-object).png \*                                                                                                                                                                                             | PNG, JPEG, WebP, GIF       |
+| Server Tag Badge            | clan-badges/[guild_id](/docs/resources/guild#guild-object)/[badge_hash](/docs/resources/user#user-object-user-primary-guild).png \*                                                                                                                                                                                                                                           | PNG, JPEG, WebP            |


Not sure what the asterisk is doing here, as this does not support GIFs, and the asterisk isn't present in the icon routes for example. Just to improve clarity.

Ref: discord/discord-api-docs#6836

* [primary guild] Add documentation for user primary guild. * Fix links * "object" * Update badge path and add null identity_enabled explainer. * Clarify null case * Update guild tag badge name * Fix tables --------- Co-authored-by: Kirby Cool <kirbydcool@gmail.com> Co-authored-by: advaith <advaithj1@gmail.com>

hammerdr marked this pull request as draft May 2, 2024 20:42

hammerdr force-pushed the clans/user-documentation branch 2 times, most recently from 90296f0 to ee625de Compare May 2, 2024 20:45

valdotle reviewed May 2, 2024

View reviewed changes

docs/resources/User.md Outdated Show resolved Hide resolved

sebm253 mentioned this pull request May 2, 2024

Add guild tags disgoorg/disgo#353

Merged

1 task

colinloretz added the not released This issue or PR is referencing a change that is not yet widely released and/or subject to change. label May 6, 2024

devsnek reviewed May 19, 2024

View reviewed changes

advaith1 mentioned this pull request Sep 28, 2024

[Closed Pull Request] - Add clan object to example user data and document clan data structure #7182

Closed

Lexedia mentioned this pull request Jan 5, 2025

add user guild tags nyxx-discord/nyxx#733

Merged

4 tasks

anthonydiscord self-requested a review May 19, 2025 21:25

Lulalaby reviewed May 26, 2025

View reviewed changes

docs/resources/User.md Outdated Show resolved Hide resolved

docs/resources/User.md Outdated Show resolved Hide resolved

docs/resources/User.md Outdated Show resolved Hide resolved

docs/resources/User.md Outdated Show resolved Hide resolved

docs/Reference.md Outdated Show resolved Hide resolved

blord0 mentioned this pull request Jun 19, 2025

Add ability to use primary guild (clan) data for users Rapptz/discord.py#10211

Merged

6 tasks

This was referenced Jun 21, 2025

feat(User): add guildtag property to User class discordjs/discord.js#10941

Closed

Add clan data to User class. discordjs/discord.js#10944

Closed

dolfies reviewed Jun 23, 2025

View reviewed changes

docs/resources/User.md Outdated Show resolved Hide resolved

advaith1 requested changes Jun 24, 2025

View reviewed changes

docs/resources/User.md Outdated Show resolved Hide resolved

docs/resources/User.md Outdated Show resolved Hide resolved

kirbycool force-pushed the clans/user-documentation branch from 6fc2a80 to eb40fbc Compare June 24, 2025 20:26

[primary guild] Add documentation for user primary guild.

96a6b93

kirbycool force-pushed the clans/user-documentation branch from eb40fbc to 96a6b93 Compare June 24, 2025 20:26

Fix links

b359b29

kirbycool requested a review from devsnek June 24, 2025 20:29

advaith1 reviewed Jun 24, 2025

View reviewed changes

docs/resources/user.mdx Outdated Show resolved Hide resolved

"object"

16d23a6

advaith1 approved these changes Jun 24, 2025

View reviewed changes

anthonydiscord approved these changes Jun 24, 2025

View reviewed changes

kirbycool marked this pull request as ready for review June 24, 2025 22:39

kirbycool requested a review from a team as a code owner June 24, 2025 22:39

kirbycool requested review from colinloretz and removed request for a team and devsnek June 24, 2025 22:39

anthonydiscord removed the not released This issue or PR is referencing a change that is not yet widely released and/or subject to change. label Jun 24, 2025

advaith1 changed the title ~~[clans] Adds documentation for user clan information~~ Document user guild tags Jun 24, 2025

ooliver1 mentioned this pull request Jun 25, 2025

feat(user): add primary_guild nextcord/nextcord#1259

Open

3 tasks

ooliver1 reviewed Jun 25, 2025

View reviewed changes

sdanialraza mentioned this pull request Jun 29, 2025

feat: user guild tags discordjs/discord-api-types#1287

Merged

Update badge path and add null identity_enabled explainer.

6faeb15

kirbycool requested a review from advaith1 July 1, 2025 19:19

kirbycool added 3 commits July 1, 2025 12:28

Clarify null case

96e17b6

Update guild tag badge name

5b010b7

Fix tables

ff3ef27

advaith1 approved these changes Jul 1, 2025

View reviewed changes

kirbycool merged commit a1bac5f into main Jul 1, 2025
4 checks passed

kirbycool deleted the clans/user-documentation branch July 1, 2025 22:19

Snazzah added a commit to Snazzah/slash-create that referenced this pull request Jul 2, 2025

feat: support primary guild / clan tags

2c1a596

Ref: discord/discord-api-docs#6836

This was referenced Jul 2, 2025

fix(CDNRoutes): correct guildTagBadge route discordjs/discord-api-types#1291

Merged

feat: support user guilds discordjs/discord.js#10962

Merged

Fleny113 mentioned this pull request Jul 3, 2025

feat: user tags discordeno/discordeno#4238

Merged

codeofandrin mentioned this pull request Jul 17, 2025

feat: Clans Rapptz/discord.py#9899

Closed

6 tasks

Document user guild tags #6836

Document user guild tags #6836

Conversation

hammerdr commented May 2, 2024 • edited by colinloretz Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

cobaltt7 commented May 3, 2024

Uh oh!

Lulalaby commented May 3, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

MinnDevelopment commented May 13, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

sumeetv commented May 14, 2024

Uh oh!

MCausc78 commented May 19, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

devsnek May 19, 2024

Choose a reason for hiding this comment

Uh oh!

Hurming commented May 2, 2025

Uh oh!

ManHatos commented May 2, 2025

Uh oh!

Dovahseod commented May 26, 2025

Uh oh!

TwilightZebby commented May 26, 2025

Uh oh!

Lulalaby left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

blord0 commented Jun 22, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

anthonydiscord left a comment

Choose a reason for hiding this comment

Uh oh!

ooliver1 Jun 25, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ooliver1 Jun 25, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

hammerdr commented May 2, 2024 •

edited by colinloretz

Loading

Lulalaby commented May 3, 2024 •

edited

Loading

MinnDevelopment commented May 13, 2024 •

edited

Loading

MCausc78 commented May 19, 2024 •

edited

Loading

Lulalaby left a comment •

edited

Loading

blord0 commented Jun 22, 2025 •

edited

Loading

ooliver1 Jun 25, 2025 •

edited

Loading