Skip to content

Commit 091aad1

Browse files
committed
[docs] Document WebP support for emoji requests
Fixes #7567 - Add information about supported emoji upload formats - Explain that all emoji formats can be served as WebP - Recommend WebP for maximum performance and compatibility - Document how to request still and animated WebP emojis
1 parent fa55719 commit 091aad1

File tree

1 file changed

+14
-0
lines changed

1 file changed

+14
-0
lines changed

docs/resources/emoji.mdx

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,12 @@ An emoji cannot have both subscription roles and non-subscription roles.
3030
Emojis with subscription roles are considered premium emoji, and count toward a separate limit of 25.
3131
Emojis cannot be converted between normal and premium after creation.
3232

33+
###### Emoji Formats
34+
35+
Emojis can be uploaded as JPEG, PNG, GIF, WebP, and AVIF formats. All emojis (regardless of original format) can be served as WebP. We highly recommend that developers request emojis as WebP for maximum performance and compatibility. The Discord client uses WebP for all emojis displayed in-app.
36+
37+
Still WebP emojis can be requested using the `.webp` file extension. For animated WebP emojis, use the `.webp` extension with the `?animated=true` query parameter.
38+
3339
###### Application-Owned Emoji
3440

3541
An application can own up to 2000 emojis that can only be used by that app.
@@ -110,6 +116,10 @@ Create a new emoji for the guild. Requires the `CREATE_GUILD_EXPRESSIONS` permis
110116
Emojis and animated emojis have a maximum file size of 256 KiB. Attempting to upload an emoji larger than this limit will fail and return 400 Bad Request and an error message, but not a [JSON status code](/docs/topics/opcodes-and-status-codes#json).
111117
:::
112118

119+
:::info
120+
We highly recommend requesting emojis as WebP for maximum performance and compatibility. See [Emoji Formats](#emoji-formats) for more details.
121+
:::
122+
113123
:::info
114124
This endpoint supports the `X-Audit-Log-Reason` header.
115125
:::
@@ -192,6 +202,10 @@ Create a new emoji for the application. Returns the new [emoji](/docs/resources/
192202
Emojis and animated emojis have a maximum file size of 256 KiB. Attempting to upload an emoji larger than this limit will fail and return 400 Bad Request and an error message, but not a [JSON status code](/docs/topics/opcodes-and-status-codes#json).
193203
:::
194204

205+
:::info
206+
We highly recommend requesting emojis as WebP for maximum performance and compatibility. See [Emoji Formats](#emoji-formats) for more details.
207+
:::
208+
195209
###### JSON Params
196210

197211
| Field | Type | Description |

0 commit comments

Comments
 (0)