Skip to content
Embed & Message image

$image[]

The function $image[] defines the main (large) image of a Discord embed. The image is displayed at the bottom of the embed in full width, after the description and the fields.

Syntax

$image[url;(embedIndex)]

Parameters

Parameter Description
url URL of the image to display. Must be a direct URL to an image file (PNG, JPG, GIF, WebP).
embedIndex Optional. Index of the targeted embed, from 1 to 10 (1 by default, also when empty). Any other value is an error.

Return Value

Modifies the response currently being constructed. Returns nothing.

Behavior

  • The image occupies the full width of the embed.
  • The URL is handed to Discord as given; an empty URL sets no image.
  • Only one call to $image[] per embed: the last call overwrites any previous ones.

Difference between $image[] and $thumbnail[]

Function Position Size
$image[] Bottom of the embed Large, full width
$thumbnail[] Top-right corner Small (square)

Examples

Simple image

$title[Photo of the Day]
$description[A beautiful photo selected for you.]
$image[https://picsum.photos/800/400]
$color[#5865F2]

Avatar as a large image

$title[Avatar of $username]
$description[**ID:** $authorID]
$image[$authorAvatar]
$color[#5865F2]

Embed combining image and thumbnail

$title[New Product]
$description[
**Name:** Gaming Pro Headset
**Price:** $79.99
**Availability:** In stock ✅
]
$thumbnail[https://cdn.example.com/product-icon.png]
$image[https://cdn.example.com/product-banner.png]
$color[#57F287]

Notes

  • The URL must be publicly accessible (no local paths).
  • Supported formats include PNG, JPEG, GIF (animated or static), and WebP.
  • For a small image in the top-right corner, use $thumbnail[] instead of $image[].

Try it

Paste an example into the playground to preview its message (functions that act on Discord are not run), or build the same thing with blocks.