Guides

Discord embed limits

Discord caps every part of an embed. Exceed any one and the API rejects the whole message with a 50035 validation error. Here is every limit in one place, plus the two message-level caps people forget.

Per-field character limits

  • title: 256 characters
  • description: 4096 characters
  • fields: up to 25 per embed
  • field.name: 256 characters
  • field.value: 1024 characters
  • footer.text: 2048 characters
  • author.name: 256 characters

Message-level limits

  • Up to 10 embeds in a single message.
  • The combined text of all embeds in a message must stay under 6000 characters: this sum includes titles, descriptions, field names/values, footers, and author names across every embed.

Gotchas

  • The 6000-char total is per message, not per embed. Three big embeds can bust it even if each is individually valid.
  • Empty strings are not the same as omitted fields; send null / omit rather than "".
  • color is a decimal integer, not a hex string. 0x5865F2 is 5793266.
  • timestamp must be an ISO 8601 string.

FAQ

What is the embed description limit?

4096 characters. Title is 256, field name 256, field value 1024, footer 2048, author name 256.

How many fields can an embed have?

Up to 25, each with a 256-character name and a 1024-character value.

How many embeds per message?

Up to 10, with a combined 6000-character cap across all of them. Build and validate yours in the embed builder.