Skip to main content

​
Structure

Each parameter in the embed is represented by a key-value pair which is separated by a colon. For example, the title parameter will look like {title: hello {user}}. The {user} is a variable which will be filled in with the user’s display name.
  • { begins a parameter.
  • : separates parameter from content.
  • $v separates the parameters.
  • } ends a parameter.
For Components v2 layouts, see the containers guide.

​
Parameters

  • url - The embed URL. (https://..)
  • color - The embed color. (#FFFFFF)
  • title - The embed title. (hello {user})
  • description - The embed description. (hello {user})
  • image - The embed image URL. (https://..)
  • thumbnail - The embed thumbnail URL. (https://..)
  • timestamp - The embed timestamp. (NO ARGUMENTS)
  • content / message - Plain text sent above the embed.
The following parameters require additional arguments which are separated by &&.
  • name - The author’s name.
  • icon - The author’s icon. Optional
  • url - The author’s URL. Optional
  • name - The field name.
  • value - The field value.
  • inline - Set to true or false for inline fields. Optional (defaults to false)
  • style_or_url - A button style (primary, secondary, success, danger) or a link URL.
  • label - The button label.
  • emoji - Optional emoji for the button.
Style aliases: blue → primary, gray/grey → secondary, green → success, red → danger.

​
Variables

You can use dynamic variables in your embeds to display user-specific information. For example, {user} will be replaced with the user’s display name.
See variables for guild, user, channel, and date/time placeholders.

​
Frequently Asked Questions

​
How can I add a new line to my description parameter?

If you want to add a new line to your description parameter, you can press SHIFT + ENTER to create a new line.

​
Why isn’t my embed code working for some commands?

Some commands allow both raw text and embed code. Because of this, you’ll need to specify if you’re entering an embed. To do this, you’ll need to begin your embed code with {embed}$v then proceed to write your embed code after as normal.

​
When should I use a container instead?

Use {container} when you want a Components v2 layout (text blocks, separators, galleries). See containers.