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. Your message must have either 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

Author

The author text inside of your embed which appears at the top of your embed, has a limit of 256 characters.

Author URL

The link that users can press on the author text in order to be redirected to the URL.

Author Icon URL

The link that will display as the image next to the author, must be a valid URL of an image.

Basic Fields

Title

The title of your embed which appears as the largest text of all embed parts, has a limit of 256 characters.

Description

The main text of your embed which is in the center, has a limit of 4096 characters.

URL

The title URL for your embed, that users can press on the author text in order to be redirected to the URL.

Embed Color

Picker

The HEX color picker for your embed, you may insert a valid HEX code or select one using the small color menu.

Color

The decimal number for the color of your embed. You can use this if you want to use a variable as a color. When left blank, the color in the picker will be used.

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

Click "Add Field" in your embed's settings to add a new field. Below you may find a list of all settings you can use for your field.

Name

A title for your field. The maximum length is 256 characters.

Value

The value is basically the content to show inside the field. The max length is 1024 characters.

Inline Field

Enable this option to make the field appear inline with the previous one, instead of adding it below.

Images

Image URL

The URL for the image that will appear in the bottom of your embed.

Thumbnail URL

The URL for the image that will appear in the top right of your embed.

Time

Timestamp

The timestamp of your embed which will appear in the bottom next to your footer, you can select the time here with a menu.

Timestamp Variable

The timestamp variable of your embed which will appear in the bottom next to your footer, you can input a variable that is either ISO or UNIX in order to display a timestamp. You can use this if you want to use a variable as a timestamp, if you'd like to display the current time you can use the {time_now_unix} variable here.

Other

Hide Embed

Option to save embeds for later and not make them appear, input "true" in the text box in order to do this.

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.


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.

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.

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