Changelog

Author: anthonydiscord

docs/change-log/2025-07-02-gradient-roles-guild-tags.md

@@ -0,0 +1,20 @@
+---
+title: "Gradient Roles and Guild Tags"
+date: "2025-07-02"
+topics:
+- "HTTP API"
+---
+
+We've documented gradient role colors and guild tags in the API. Guild tags allow users to rep their primary server with a four character badge next to their display name. They can be accessed from `primary_guild` on a user. Gradient role colors allow servers to have roles with gradient colors instead of a single, solid color. They can be found as `colors` when interacting with roles in guilds. As part of this change we have deprecated the `color` field on roles, but it will still work for backwards compatibility.
+
+#### Gradient Role Colors
+
+- The guild feature `ENHANCED_ROLE_COLORS` will let you know if a guild is able to set gradient colors to roles. 
+- Guild roles now have `colors` as part of the [structure](/docs/topics/permissions#role-object-role-structure).
+- `color` on guild roles is deprecated but will still be returned by the API and continues to work for backwards compatibility.
+- [Role color structure](/docs/topics/permissions#role-object-role-colors-object)
+
+#### Guild Tags
+
+- Guild tags can be retrieved through the user `primary_guild` field.
+- [User Primary Guild](/docs/resources/user#user-object-user-primary-guild)