Skip to content

Commit b46279c

Browse files
anthonydiscordAlmostSuspenseQjuh
authored
Changelog for Gradient Roles and Guild Tags (#7661)
* Deprecate color * Changelog * Update docs/change-log/2025-07-02-gradient-roles-guild-tags.md Co-authored-by: Suspense <[email protected]> * Update docs/change-log/2025-07-02-gradient-roles-guild-tags.md Co-authored-by: Suspense <[email protected]> * Update docs/change-log/2025-07-02-gradient-roles-guild-tags.md * Update docs/change-log/2025-07-02-gradient-roles-guild-tags.md Co-authored-by: Qjuh <[email protected]> --------- Co-authored-by: Suspense <[email protected]> Co-authored-by: Qjuh <[email protected]>
1 parent f269a0e commit b46279c

File tree

3 files changed

+23
-3
lines changed

3 files changed

+23
-3
lines changed

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

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
---
2+
title: "Gradient Roles and Guild Tags"
3+
date: "2025-07-02"
4+
topics:
5+
- "HTTP API"
6+
---
7+
8+
We've documented gradient role colors and guild tags in the API. Guild tags let users rep their favorite server with a 1-4 character badge next to their display name. They can be accessed using the `primary_guild` field on the user object. Servers can now give gradient colors to their roles instead of a single, solid color. Gradient colors use the new `colors` field on the role object. As part of this change, the `color` field on roles is now deprecated, but it will still work for backwards compatibility.
9+
10+
#### Gradient Role Colors
11+
12+
- The guild feature `ENHANCED_ROLE_COLORS` will let you know if a guild is able to set gradient colors to roles.
13+
- Guild roles now have `colors` as part of the [structure](/docs/topics/permissions#role-object-role-structure).
14+
- `color` on guild roles is deprecated but will still be returned by the API and continues to work for backwards compatibility.
15+
- [Role color structure](/docs/topics/permissions#role-object-role-colors-object)
16+
17+
#### Guild Tags
18+
19+
- Guild tags can be retrieved through the `primary_guild` field on the user object.
20+
- [User Primary Guild](/docs/resources/user#user-object-user-primary-guild)

‎docs/resources/guild.mdx‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1239,7 +1239,7 @@ This endpoint supports the `X-Audit-Log-Reason` header.
12391239
|---------------|-------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------|
12401240
| name | string | name of the role, max 100 characters | "new role" |
12411241
| permissions | string | bitwise value of the enabled/disabled permissions | @everyone permissions in guild |
1242-
| color* | integer | RGB color value | 0 |
1242+
| color* | integer | **Deprecated** RGB color value | 0 |
12431243
| colors | [role colors](/docs/topics/permissions#role-object-role-colors-object) object | the role's colors | [default role colors object](/docs/topics/permissions#role-object-default-role-colors-object) |
12441244
| hoist | boolean | whether the role should be displayed separately in the sidebar | false |
12451245
| icon | ?[image data](/docs/reference#image-data) | the role's icon image (if the guild has the `ROLE_ICONS` feature) | null |
@@ -1285,7 +1285,7 @@ This endpoint supports the `X-Audit-Log-Reason` header.
12851285
|---------------|-------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------|
12861286
| name | string | name of the role, max 100 characters |
12871287
| permissions | string | bitwise value of the enabled/disabled permissions |
1288-
| color* | integer | RGB color value |
1288+
| color* | integer | **Deprecated** RGB color value |
12891289
| colors | [role colors](/docs/topics/permissions#role-object-role-colors-object) object | the role's colors |
12901290
| hoist | boolean | whether the role should be displayed separately in the sidebar |
12911291
| icon | [image data](/docs/reference#image-data) | the role's icon image (if the guild has the `ROLE_ICONS` feature) |

‎docs/topics/permissions.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -207,7 +207,7 @@ Roles represent a set of permissions attached to a group of users. Roles have na
207207
|----------------|-------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------|
208208
| id | snowflake | role id |
209209
| name | string | role name |
210-
| color* | integer | integer representation of hexadecimal color code |
210+
| color* | integer | **Deprecated** integer representation of hexadecimal color code |
211211
| colors | [role colors](/docs/topics/permissions#role-object-role-colors-object) object | the role's colors |
212212
| hoist | boolean | if this role is pinned in the user listing |
213213
| icon? | ?string | role [icon hash](/docs/reference#image-formatting) |

0 commit comments

Comments
 (0)