Embeds are attached to messages and have a special design. The usually look like this:


🔨 Creating an Embed

Javacord provides an EmbedBuilder which can be used to create embeds:

// Create the embed
EmbedBuilder embed = new EmbedBuilder()
    .setAuthor("Author Name", "http://google.com/", "https://cdn.discordapp.com/embed/avatars/0.png")
    .addField("A field", "Some text inside the field")
    .addInlineField("An inline field", "More text")
    .addInlineField("Another inline field", "Even more text")
    .setFooter("Footer", "https://cdn.discordapp.com/embed/avatars/1.png")
    .setImage(new File("C:/Users/Bastian/Pictures/puppy.jpg"))
    .setThumbnail(new File("C:/Users/Bastian/Pictures/kitten2.png"));
// Send the embed

📷 Supported Image Sources

By default, Discord expects embed images to be a link (e.g., the image link used in setFooter(...)), but you can also use attachments for images. If you provide a non-url image source (e.g. the puppy.jpg file used in setImage(...)), Javacord automatically uploads them as an attachment to the message and uses this attachment for the embed.

🔒 Embed Limits

Title256 characters
Description4096 characters
Field AmountUp to 25 fields
Field Name256 characters
Field Value1024 characters
Footer Text2048 characters
Author Name256 characters

In addition to the limits above, the sum of all characters in an embed structure must not exceed 6000 characters.


What is the second parameter of setAuthor(...)?

.setAuthor("Author Name", "http://google.com/", "https://cdn.discordapp.com/embed/avatars/0.png")
  • First parameter: The name of the author
  • Second parameter: A link for the author (e.g. their homepage). Can be null.
  • Third parameter: The avatar of the author

What's the difference between an inline field and a normal one?

Normal fields always start in a new line, whereas several inline fields can be in the same line.

Can I change the placement of inline fields?

No, Discord does not allow different embed layouts.

How can I format text in an embed?

Discord allows for a subset of markdown to be used. See their docsopen in new window for the specifics.