Skip to content

Commit b46279c

Browse files
anthonydiscordAlmostSuspenseQjuh
authored
Changelog for Gradient Roles and Guild Tags (discord#7661)
* Deprecate color * Changelog * Update docs/change-log/2025-07-02-gradient-roles-guild-tags.md Co-authored-by: Suspense <64612795+AlmostSuspense@users.noreply.github.com> * Update docs/change-log/2025-07-02-gradient-roles-guild-tags.md Co-authored-by: Suspense <64612795+AlmostSuspense@users.noreply.github.com> * 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 <76154676+Qjuh@users.noreply.github.com> --------- Co-authored-by: Suspense <64612795+AlmostSuspense@users.noreply.github.com> Co-authored-by: Qjuh <76154676+Qjuh@users.noreply.github.com>
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)
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy