Tags

{message} Tags

Tip

Looking to send a message? You want the {responder} tags.

{message.id;message}

Returns the ID of a message.

NameTypeDefault
messageMessagecontext Message

{message.content;message}

Returns a string with the content of a message.

NameTypeDefault
messageMessagecontext Message

{message.delete;message;reason}

Note

This tag is part of the Mutate Message expensive group. This tag is marked Dangerous.

Deletes a message.

NameTypeDefaultDescription
messageMessagecontext MessageThe message to delete.
reasonstring?The reason for deleting the message.

{message.pinned;message}

Checks if a message is pinned.

NameTypeDefault
messageMessagecontext Message

{message.pin;message;reason}

Note

This tag is part of the Mutate Message expensive group.

Pins a message.

NameTypeDefaultDescription
messageMessagecontext MessageThe message to pin.
reasonstring?The reason for pinning the message.

{message.unpin;message;reason}

Note

This tag is part of the Mutate Message expensive group.

Unpins a message.

NameTypeDefaultDescription
messageMessagecontext MessageThe message to unpin.
reasonstring?The reason for unpinning the message.

{message.publish;message}

Note

This tag is part of the Mutate Message expensive group.

Publishes a message. Only works in news channels.

NameTypeDefault
messageMessagecontext Message

{message.embed;message;index}

Get an embed from the message.

NameTypeDefaultDescription
messageMessagecontext MessageThe message to get the embed of.
indexnumber0The index of the embed to get. Defaults to 0.
{=embed;{message.embed}}
{$embed.title}

{message.referenceId;message}

The ID of the message this message is replying to.

NameTypeDefault
messageMessagecontext Message

{message.addReaction;emoji;message}

Note

This tag is part of the Mutate Reaction expensive group.

Adds a reaction to a message.

NameTypeDefaultDescription
emojiEmojiThe emoji to add as the reaction.
messageMessagecontext MessageThe message to react to.

{message.removeReaction;emoji;user;message}

Note

This tag is part of the Mutate Reaction expensive group.

Removes a reaction from a message.

NameTypeDefaultDescription
emojiEmojiThe emoji to remove as the reaction.
userUser?The user to remove the reaction from.
messageMessagecontext MessageThe message to remove a reaction from.

{message.removeReactions;emoji;message}

Note

This tag is part of the Mutate Reaction expensive group.

Removes all reactions, optionally for a specific emoji.

NameTypeDefaultDescription
emojiEmoji?The emoji to remove reactions for. If omitted, all reactions are removed.
messageMessagecontext MessageThe message to remove reactions from.
{message.removeReactions}       // Will remove all reactions
{message.removeReaction;emoji} // Will remove all reactions for a specific emoji

Returns a string with the jump URL of a message.

NameTypeDefault
messageMessagecontext Message

{message.authorId;message}

Returns the ID of the author of a message.

NameTypeDefault
messageMessagecontext Message

{message.channelId;message}

Returns the ID of the channel a message is in.

NameTypeDefault
messageMessagecontext Message

{message.tts;message}

Checks if a message was sent as text to speech.

NameTypeDefault
messageMessagecontext Message

{message.mentions;message}

Get a list of mentions from a message. Returns an array of IDs that includes roles, channels and users.

NameTypeDefault
messageMessagecontext Message

{message.reactions;message}

Get a list of reactions from a message. Returns an array of objects. For example, this message

A screenshot of a message with an :eggplant: and :fortnitedefaultdance: reaction.

Would result in this

[
  {
    "count": 1,
    "me": false,
    "emoji": {
      "id": null,
      "animated": false,
      "name": "🍆"
    }
  },
  {
    "count": 1,
    "me": false,
    "emoji": {
      "id": "538224338269372438",
      "animated": true,
      "name": null
    }
  }
]
{=reactions;{message.reactions}}
{$reactions.0.count} // 1
{$reactions.0.me} // false (whether the bot has reacted with this message)
{$reactions.0.emoji.id} // null
{$reactions.0.emoji.animated} // false
{$reactions.0.emoji.name} // 🍆
NameTypeDefault
messageMessagecontext Message

See objects for information on working with objects.

{message.attachments;message;single;objects}

Get the attachments from a message.

NameTypeDefaultDescription
messageMessagecontext MessageThe message to get attachments from.
singlebooleantrueWhether to return a single attachment or an array.
objectsbooleanfalseWhether to return attachment urls or an array of attachment objects.

{message.createdAt;message}

Returns a timestamp for the creation date of a message that can be used with {time}.

NameTypeDefault
messageMessagecontext Message