$editEmbedIn[] — Delayed Embed Editing
$editEmbedIn[] schedules the replacement of the embed of the message sent by the command after a delay. The new embed is built from the arguments of the function itself (title, description, footer, color), not from $title / $description calls placed after it.
Syntax
$editEmbedIn[duration;title;(description);(footer);(color)]
Parameters
| Parameter | Required | Description |
|---|---|---|
duration |
Yes | Delay before editing. Positive, at most 40 minutes. A plain number is read as seconds; units such as s, m, h are accepted. |
title |
Yes (may be empty) | New embed title. The argument must be present, but it may be empty when description or footer is set. |
description |
No | New embed description (empty by default). |
footer |
No | New embed footer text (empty by default). |
color |
No | Embed color: #RRGGBB, RRGGBB (hex) or an integer between 0 and 16777215. A value made only of digits is read as a decimal integer (123456 is the number 123456, not hex). Invalid values raise “Invalid embed color.”. |
Between 2 and 5 arguments are accepted. At least one of title, description, footer must be non-empty (“At least one embed text field is required.”).
Duration Format
| Format | Unit | Example |
|---|---|---|
X |
Seconds (plain number, decimals allowed) | 5, 2.5 |
Xms |
Milliseconds | 500ms |
Xs |
Seconds | 3s, 10s |
Xm |
Minutes | 1m, 5m |
Xh |
Hours | 1h (rejected: above 40 minutes) |
Longer spellings (sec, minutes, …) and units d, w, y are parsed too, and parts can be combined (1m30s), but the total must stay within 40 minutes.
Return value
An empty string. The edit is scheduled and applied to the response message of the command.
Examples
Progress indicator
Updating...
$title[Progression]
$description[🟡 Processing data...]
$color[#F1C40F]
$editEmbedIn[5s;Progression;🟢 Completed successfully!;;#2ECC71]
Status change
$title[🔍 Search in progress]
$description[Analyzing database...]
$color[#3498DB]
$footer[Please wait...]
$editEmbedIn[3s;✅ Search completed;3 results found;Completed;#2ECC71]
Notes
- Limits: title 256 characters, description 4096, footer 2048, 6000 in total (otherwise the call fails with a Discord-limits error).
- The edit targets the command’s main response; messages sent with
$sendMessage[]are not edited, and with no main response nothing is edited. - The embed is replaced entirely by the one built from the arguments (no merging): omitted fields become empty.
- The edit is built with an empty
contentand a replacement embed. - The maximum duration is 40 minutes.
- To change the text of the message, use
$editIn[]. - A Components V2 message carries neither text nor embed: the call fails with
This message uses Components V2: edit it with $editMessageCV2.For a delayed edit of a V2 layout, use$editInCV2.
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.