Embed & Message
title
$title[]
The function $title[] sets the title of a Discord embed. The title is the most visible text of the embed, displayed at the top in bold with a larger font.
Syntax
$title[text;(embedIndex)]
Parameters
| Parameter | Description |
|---|---|
text |
The text of the title. You can use Discord markdown syntax (bold, italics, underline, etc.). |
embedIndex |
Optional. Index of the embed to modify, from 1 to 10 (1 by default, also when empty). Any other value is an error. Use it to build several embeds in the same message (maximum of 10). |
Return Value
This function returns nothing; it modifies the response currently being constructed. The pending embed is emitted automatically at the end of the script as the response; $sendMessage[text] does not send it, it posts a separate channel message and leaves the pending response untouched. See Execution model.
Behavior
$title[]is a response mutation: it is added to the response currently in progress and is emitted with the pending response at the end of the script.- If you call
$title[]several times for the same embed index, only the last call is applied. - The order of the embed functions does not matter: each call fills one property of the embed at its index, and the embed is built when the response is sent.
- The title is limited to 256 characters; a longer text is an error (“Embed text cannot exceed 256 characters.”). The total text of all the embeds (titles, descriptions, fields, footers, author names) is limited to 6000 characters.
- An embed whose properties are all empty is not sent.
Examples
Simple Embed with Title
$title[Welcome to the server!]
$description[Thank you for joining us 🎉]
$color[#5865F2]
Title with Markdown Formatting
$title[**Important Announcement** — *Must Read* 📢]
$description[Here is the latest news of the server.]
$color[#FF0000]
Multi-embed: Different Titles for Each Embed
$title[First embed;0]
$description[Content of the first embed;0]
$color[#5865F2;0]
$title[Second embed;1]
$description[Content of the second embed;1]
$color[#57F287;1]
Notes
- The maximum length of the title is 256 characters.
- If the text is empty, the title will not be displayed in the embed.
- For an embed without a title, simply omit the call to
$title[].
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.