ShapelessAI← All specs

discordUnicode code pointsVerified by Tal Weiss

Discord character limit and media specs

A Discord post holds up to 2,000 characters, with 10 images, 10 video, a PDF document. Every number below is the one our publishing engine enforces before a Discord post goes out, with the source it came from and the date we last read it.

Text[text]

Discord text limits
Max length2,000 Unicode code points
CountingCounted in Unicode code points: one plain character is one, and a link costs its full length.

Media

Discord media constraints by kind
ConstraintImages[image]VideoDocuments
Per post101010
Formats.png, .jpg, .jpeg, .gif, .webp.mp4, .mov, .webm.pdf
Max size20 MB20 MB20 MB
Max length---
We publish ityesyesyes

We publish text, images, video and PDF documents here.

Mentions

User/role mentions need snowflake ids (<@id>) - plain text unless verified.

The guidance our own agent carries for Discord, verbatim.

How our publisher handles it

The notes our publishing engine carries for Discord, verbatim - what our adapter does, not only what the platform allows.

  • At most 10 attachments per message in total, and 25 MiB for the whole message.

Questions

How long can a Discord post be?
2,000 characters. Counted in Unicode code points: one plain character is one, and a link costs its full length.
How many images can one Discord post have?
Up to 10: .png, .jpg, .jpeg, .gif, .webp, up to 20 MB each.
What video does Discord accept?
10 video per post: .mp4, .mov, .webm, up to 20 MB each.
How do you tag an account on Discord?
User/role mentions need snowflake ids (<@id>) - plain text unless verified.

Sources, verified 2026-09-29

Each citation names where the number came from. Anything we could not confirm in an official document is marked, because a number nobody will stand behind should look different from one that is.

  1. [text]discord.com/developers/docs/resources/webhook#execute-webhook content up to 2000 characters, wait=true returns the messagediscord.com/developers/docs/resources/webhook#execute-webhookverified 2026-09-29
  2. [image]discord.com/developers/docs/reference#uploading-files 20 MiB per file default, Nitro/boost raise it; create-message 25 MiB per requestdiscord.com/developers/docs/reference#uploading-filesverified 2026-09-29
  3. [attachments]discord.com/developers/docs/topics/opcodes-and-status-codes 30015 max 10 attachments per messagediscord.com/developers/docs/topics/opcodes-and-status-codesverified 2026-09-29
  4. [rateLimit]discord.com/developers/docs/topics/rate-limits: per-webhook bucket, never hardcode, honor retry_after; no per-minute number publisheddiscord.com/developers/docs/topics/rate-limitsverified 2026-09-29