Send or Edit a Message
The Send or Edit a Message action lets you send a message or edit an already existing message with content, embeds, or components.
Message Builder
The Message Builder allows you to create a message for your bot to send when the action is ran. You can build it via a traditional message builder or by using the more flexible and customizable Components V2.
The message builder allows you to build a message with content, valid embeds, or components.
Message Content
The message content is the plain text attached to your message, has a max of 2000 characters. It can contain mentions that will ping the user / role. However, if the Response Type is set to a reply, no ping will be issued.
Embeds
Embeds are a stylish way to show content with your bot. Below you may find information on each part of an embed.
Author
Basic Fields
Embed Color
Fields
Fields are a type of content you can add right below the description of your embed. You can add up to 25 fields per embed, and give each one a name and a value
Images
Footer
Time
Other
Components V2 allows you to build a more structured and customizable message, allowing you to put embeds (which are named containers instead), plain content, attachments, buttons and select menus in the order you prefer. Fields such as titles or footers do not exist in this version of the message builder, and are replaced by headers and subtexts respectively. Learn more here.
Components
Messages are built with elements named "components". To add a component, simply drag it to the canvas in the position you wish it to appear, or select it from the suggested options. You can then configure it from the right sidebar.
There are various components, divided in 3 main sections:
Layout blocks, such as containers, define how other components should appear and how the message should look.
Content components allow you to display actual information, such as text or attachments.
Components that can be pressed by users: buttons and select menus
Response Type
The send or edit a message action offers multiple response types, which allow you to decide where and how your message should be sent. There are 4 categories of response types, all of them are listed and explained below.
The message will simply reply to the command / event or the most recent interaction.
The message will reply to a specific message and ping the author of the message it replies to.
The message will be sent to the channel where the command was used in, the event was triggered in or the last interaction was triggered in.
Reply to the command
The message will simply reply to the command / event or the most recent interaction.
Reply to a specific message
The message will reply to a specific message and ping the author of the message it replies to.
Channel ID
Here you can set the ID of the channel where the message you're replying to is in. You can do this by pasting an ID directly from Discord (learn how here) or using a variable that returns a channel ID. These can be easily added through the variable selector by clicking the Clipboard button.
Message ID
Here you can set the ID of the message the message will reply to. You can do this by pasting an ID directly from Discord (learn how here) or using a variable that returns a message ID. These can be easily added through the variable selector by clicking the Clipboard button.
Send the message to the channel the command was used in
The message will be sent to the channel where the command was used in, the event was triggered in or the last interaction was triggered in.
The message will be sent to a specific channel from an ID of a channel.
The message will be sent to the selected channel in a channel option.
Send the message in a forum post.
Send the message to a specific channel
The message will be sent to a specific channel from an ID of a channel.
Channel ID
Here you can set the ID of the channel where the message will be sent to. You can do this by pasting an ID directly from Discord (learn how here) or using a variable that returns a channel ID. These can be easily added through the variable selector by clicking the Clipboard button.
Send the message to a channel option
The message will be sent to the selected channel in a channel option.
Channel Option
The channel option of a text channel, such as {option_channel}. If you want to use a variable, use the Send the message to a specific channel response type
Send the message in a new forum post
The message will be sent to a new form post created in the specified forum channel.
Forum ID
Here you can set the ID of the forum that the post will be created in. You can do this by pasting an ID directly from Discord (learn how here) or using a variable that returns a channel ID. These can be easily added through the variable selector by clicking the Clipboard button.
Post Title
The title for the new forum post. You can use plain text or variables that return plain text here.
The message will be sent directly to the user who used the command, triggered the event, pressed a button, or selected a menu.
The message will be sent directly to the user who was selected in a user option.
The message will be sent directly to the specified user ID.
Direct message the user who used the command
The message will be sent directly to the user who used the command, triggered the event, pressed a button, or selected a menu.
Direct message a user option
The message will be sent directly to the user who was selected in a user option.
User Option
The user option that will be directly message, such as {user_option}.
Direct message a specific user
The message will be sent directly to the specified user ID.
DM User ID
The user ID of a member inside of your server that will be getting the DM.
The message you created will be the edited version of a previous sent message in your command or event's tree.
The message you created will edit another previously sent message with a channel and message ID.
Edit a message sent by another action
The message you created will be the edited version of a previous sent message in your command or event's tree.
Response Action
The message action from your tree that will be edited to the message you have setup.
Keep Components
This option allows you to keep the buttons or select menu options of the original message you're editing.
Edit a specific message
The message you created will edit another previously sent message with a channel and message ID.
Channel ID
Here you can set the ID of the channel where the message you're replying to is in. You can do this by pasting an ID directly from Discord (learn how here) or using a variable that returns a channel ID. These can be easily added through the variable selector by clicking the Clipboard button.
Message ID
Here you can set the ID of the message the message will reply to. You can do this by pasting an ID directly from Discord (learn how here) or using a variable that returns a message ID. These can be easily added through the variable selector by clicking the Clipboard button.
Keep Components
This option allows you to keep the buttons or select menu options of the original message you're editing.
Optional Variable
You can also create your own variable that can be used anywhere in the command to get the ID of the message sent by the action. This is useful when using Send an API Request in your command / event and you need the ID of the message. Make sure that the name of the variable does not correspond to the name of a default variable or of an another action.
You can copy the variable by clicking the clipboard icon in the section right below the optional variable field.
Allowed Mentions
In this section you can control which mentions are allowed to ping users. By default, all mentions have been allowed. If you want to change this, press the "Configure Mentionables" button to configure it. This setting is optional.
Simple mode is shown by default when you press the "Configure Mentionables" button above.
Allowed Mention Types
@everyone and @here
This toggle will enable or disable the @everyone and @here mentions for the message.
Role Mentions
The role mentions toggle will enable or disable @role mentions for the message.
User Mentions
This toggle will enable or disable the @user mentions in the message.
Advanced mode can be accessed by selecting it in the Configuration Mode.
Specific Mentionables
Allowed role IDs
In this field you can enter role IDs or variables that are allowed to be pinged in the message. Seperate each with a comma (,).
Allowed user IDs
In this field you can enter user IDs or variables that are allowed to be pinged in the message. Seperate each with a comma (,).
Mention Replied User
Enabling this option will allow the user the bot is replying to to be pinged.
Adding Components
In order to add a button or select menu to your message, you must click on either of the buttons on your "Send or Edit a Message" action block.
Adding a Button
If you would like to add a button, you must press the button in the bottom left of your block with the plus sign titled "Button". After you press this, a button will be added to your message and will be attached to it. For more information about buttons, check out the Button page.
Adding a Select Menu
If you would like to add a select menu, you must press the button in the bottom right of your block with the plus sign titled "Menu". After you press this, a select menu will be added to your message and will be attached to it. For more information about Select Menus, check out the Select Menu page.
Requirements and Limits
Inside of your message, there are requirements and limits that Discord has in place. Your message must follow these requirements and limits in order for it to function properly.
General
Your message must include valid message content, an embed, or a component in order for your message to send.
Message
You may only have up to 10 embeds on your message.
The total number of characters in the title, description, field.name, field.value, footer.text, and author.name fields across all embeds in a message must not go above 6000 characters.
When adding an embed, at least one of the following fields is required: title, description, or author.
If you have a footer icon, you must have footer text.
If you have a author icon, you must have a author text.
Each embed field requires a title and some content.
Single spaces cannot bypass any of the requirements listed above.
Components
You can only have up to 5 action rows.
You can only have up to 5 buttons per row.
You can only have 1 select menu per row.
You can't have a select menu and a button in the same row.
Last updated
Was this helpful?