# Embeds

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

Embed

# 🔨 Creating an Embed

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

// Create the embed
EmbedBuilder embed = new EmbedBuilder()
    .setTitle("Title")
    .setDescription("Description")
    .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")
    .setColor(Color.BLUE)
    .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
channel.sendMessage(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

Type Limit
Title 256 characters
Description 2048 characters
Field Amount Up to 25 fields
Field Name 256 characters
Field Value 1024 characters
Footer Text 2048 characters
Author Name 256 characters

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

# ❓ FAQ

# 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.