Discord embed limits: the cheat sheet for message designers
Discord refuses messages that break its limits, and the error rarely says which part was too long. Keep these numbers next to you while you design.
Short answer
A Discord message allows 2,000 characters of content and up to 10 embeds. Each embed allows a 256-character title, a 4,096-character description and 25 fields, and all embeds together are capped at 6,000 characters. Components V2 messages allow 40 components and 4,000 characters of text.
Message-level limits
Everything starts with the message itself. The plain text above any embeds, which Discord calls the message content, can be up to 2,000 characters. A single message can carry up to 10 embeds. Hitting the embed count is rare. Hitting the shared character budget is not, and that budget is the next table.
Limits for each embed
| Part | Limit | Design tip |
|---|---|---|
| Title | 256 characters | Write it like a headline, not a sentence |
| Description | 4,096 characters | The right home for rules and long text |
| Fields | 25 per embed | Use them for facts, not paragraphs |
| Field name | 256 characters | Keep it to a label: Date, Host, Price |
| Field value | 1,024 characters | Move anything longer into the description |
| Footer text | 2,048 characters | Ideal for a short note or update date |
The 6,000-character trap
All text across every embed in one message counts toward a combined 6,000-character cap: titles, descriptions, field names and values, footers and author names. A rules post split into five tidy embeds can be fine one by one and still fail as a whole. If you get close, split the content into two messages instead of squeezing it.
Markdown counts. A bold word wrapped in ** costs four extra characters, and a mention like <@&123456789012345678> costs more than twenty, even though members only see a short name.
Components V2 limits
Components V2 messages follow a different budget, because the layout is built from pieces rather than one card:
- 40 components per message, counting containers, sections, separators, buttons and the like
- 4,000 characters of text across all components combined
- 10 images in a single media gallery
A container with three sections, a gallery and two separators uses components quickly, so sketch the layout before filling in the copy. The Components V2 building guide walks through every block and what it costs.
Habits that keep you under every limit
- Put long text in a description, never spread across many fields.
- Use inline fields for short facts. Three fit side by side.
- Reuse one embed per topic rather than one per sentence.
- Shorten link text: the URL inside markdown counts too.
- Check the total before you add the last embed, not after Discord rejects it.
The RestoreCord embed builder runs the supported checks as you type and highlights the part that needs attention, so you learn about an overlong field in the editor instead of from a failed send. Discord's own permissions, upload limits and rate limits still apply on top.
Ready to send? Read how to get a webhook URL and keep it private, see how to attach embed images without a host, or head back to the RestoreCord Embeds home page.
Embed limit questions
Let the builder do the counting
Design your message with live limit checks and send it the moment it's ready.