Skip to content

Commit 9bd5d0c

Browse files
committed
[docs] Update reference documentation for emoji formats
- Add AVIF to supported image formats - Add AVIF to supported Custom Emoji formats - Include emoji format information and WebP recommendations in footnotes
1 parent 915e912 commit 9bd5d0c

File tree

1 file changed

+4
-1
lines changed

1 file changed

+4
-1
lines changed

docs/reference.mdx

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -325,13 +325,14 @@ Discord uses ids and hashes to render images in the client. These hashes can be
325325
| PNG | .png |
326326
| WebP | .webp |
327327
| GIF | .gif |
328+
| AVIF | .avif |
328329
| Lottie | .json |
329330

330331
###### CDN Endpoints
331332

332333
| Type | Path | Supports |
333334
|-----------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------|
334-
| Custom Emoji | emojis/[emoji_id](/docs/resources/emoji#emoji-object).png | PNG, JPEG, WebP, GIF |
335+
| Custom Emoji | emojis/[emoji_id](/docs/resources/emoji#emoji-object).png \*\*\*\*\* | PNG, JPEG, WebP, GIF, AVIF |
335336
| Guild Icon | icons/[guild_id](/docs/resources/guild#guild-object)/[guild_icon](/docs/resources/guild#guild-object).png \* | PNG, JPEG, WebP, GIF |
336337
| Guild Splash | splashes/[guild_id](/docs/resources/guild#guild-object)/[guild_splash](/docs/resources/guild#guild-object).png | PNG, JPEG, WebP |
337338
| Guild Discovery Splash | discovery-splashes/[guild_id](/docs/resources/guild#guild-object)/[guild_discovery_splash](/docs/resources/guild#guild-object).png | PNG, JPEG, WebP |
@@ -361,6 +362,8 @@ Discord uses ids and hashes to render images in the client. These hashes can be
361362

362363
\*\*\*\* In the case of the Sticker endpoint, the sticker will be available as PNG if its [`format_type`](/docs/resources/sticker#sticker-object) is `PNG` or `APNG`, GIF if its `format_type` is `GIF`, and as [Lottie](https://airbnb.io/lottie/#/) if its `format_type` is `LOTTIE`.
363364

365+
\*\*\*\*\* For Custom Emoji, we highly recommend requesting emojis as WebP for maximum performance and compatibility. Emojis can be uploaded as JPEG, PNG, GIF, WebP, and AVIF formats. WebP and AVIF formats must be requested as WebP since they don't convert well to other formats. The Discord client uses WebP for all emojis displayed in-app. See the [Emoji Resource](/docs/resources/emoji) page for more details.
366+
364367
:::info
365368
Sticker GIFs do not use the CDN base url, and can be accessed at `https://media.discordapp.net/stickers/<sticker_id>.gif`.
366369
:::

0 commit comments

Comments
 (0)