Embed Feature

In this page you will learn about Embed Feature.

Behind Story

Our goal is to create a Discord Bot that is easy to use and has an awesome UI Design. Creating a fully embed message has been super hard to manage or required user to use website to be able to have better UI to create it. After Discord introduced buttons and selects, we knew that this was the answer to all of them. We're excited to bring you a new way to create embed messages on Discord with our Embed Creator and we hope you're excited too!

Use Cases

• Server announcement

• About us page

• Information message

/embed create

To create new embed message with embed creator.

Embed Section On & Off

Embed Section On & Off

1st menu will be the Embed Section On & Off. You can easily to turn it on and off any part of your embed and Mr. Tom will update the UI so you will have better idea how it will looks like when you post it.

Good to know: Turn it on and off the section it will not reset the message.

Embed Section Edit

2nd menu will be the Embed Section Edit. In here you can edit the embed message or image. Select which part you want to edit and Mr. Tom will update the embed for you. This menu is dynamic based on your Embed.

Good to know: The Embed Creator will keep your data updated as you edit it for a better visual of your embed message. Once you are ready, you can click Save & Post and the bot will post the embed message you just created to the channel you choose.

Commands

Usage
/embed create (channel) (role_mention)

Important: By default only members with Manage Messages can use this command. See Discord Slash Command Permissions to customize it.

Check this: [] is a required command option, () is an optional command option

Command Options

Option	Description
channel	Channel where the bot will post the embed
role_mention	Select role to mention when embed message is posted

Tips: To learn more on how to create Embed JSON file go to Embed JSON.

/embed edit

To edit bot existing embed message.

/embed edit

Command

Usage
/embed edit [message_link] (message_channel)

Check this: [] is a required command option, () is an optional command option

Command Options

Option	Decription
message_link	Specify message by the link or ID
message_channel	Channel where your message is. This will be faster for bot to find the message

Good to know: You can get message link on PC by right click on your message or tap and hold your message on mobile app

/embed json

/embed json

Now you can create embed message with JSON file. It is very useful for moderators to post pre-made messages in JSON file. This feature also supports sending messages through multiple channels or servers simultaneously.

What is JSON?

JSON is a text-based data format that is used to store and transfer data. For example, // JSON syntax { "title": "Your Title", "description": "Your description" } In JSON, the data are in key/value pairs separated by a comma. Please check out this link to find more about the JSON What is JSON?

Once we understand JSON, there are 2 ways to create a new JSON.

1. Using Text Editor

2. Using Online Tools such as https://www.tutorialspoint.com/online_json_editor.htm

Before creating Embed JSON file you have to know the structure. All elements listed here are optional but you still need to use the content or embeds object at least once. This is the minimal requirement.

Command

Usage
/embed json [file]

Important: Only user with Manager Role can use this command.

Check this: [] is a required command option, () is an optional command option

Embed Data

• embeds : [array] - array of embed objects. That means, you can add more than one embed data

  • send_to : [object] - send_to object

    • note : [string] - note of the channel

    • server_id : [integer] - discord server id where the channel is

    • channel_id : [integer] - discord channel id where embed will be posted

  • content : [string] - add message before embed

  • attachment : [url of image] - add image attachment outside embed

  • role_mention : [integer] - role tagged by the id

  • author : [object] - embed author object

    • name : [string] - name of author

    • url : [url of website] - url of author. If name was used, it becomes a hyperlink

    • icon_url : [url of image] - url of author icon

  • title : [string] - title of embed

  • url : [url of website] - url of embed. If title was used, it becomes hyperlink

  • description : [string] - description text

  • color : [number] - color code of the embed. You have to use Decimal numeral system, not Hexadecimal. Use color picker and converter
  • fields : [array] - array of embed field objects

    • name : [string] - name of the field

    • value : [string] - value of the field

    • inline : [bool] - if true, fields will be displayed in same line, but there can only be 3 max in same line or 2 max if you used thumbnail

  • thumbnail : [object] - embed thumbnail object

    • url : [url of image] - url of thumbnail

  • image : [object] - embed image object

    • url : [url of image] - url of image

  • footer : [object] - embed footer object

    • text : [string] - footer text, doesn't support Markdown

    • icon_url : [url of image] - url of footer icon

Sample 1

Send 1 full embed to 1 channel

{
  "embeds": [
    {
      "send_to": [
        {
          "note": "Mr. Tom Support - Announcement Channel",
          "server_id": 781677817669877800,
          "channel_id": 875787516035350568
        }
      ],
      "author": {
        "name": "CLY",
        "url": "https://mrtom.space",
        "icon_url": "https://image.jpg"
      },
      "title": "Title",
      "url": "https://mrtom.space",
      "description": "Text message Role: <@&845857997346308116> Channel: <#863915586425192478>",
      "color": 15258703,
      "fields": [
        {
          "name": "Text",
          "value": "More text",
          "inline": true
        },
        {
          "name": "Even more text",
          "value": "Yup",
          "inline": true
        }
      ],
      "thumbnail": {
        "url": "https://image.jpg"
      },
      "image": {
        "url": "https://image.jpg"
      },
      "footer": {
        "text": "Footer message",
        "icon_url": "https://image.jpg"
      }
    }
  ]
}

Sample 2

Send 1 simple embed to 2 channels

{
  "embeds": [
    {
      "send_to": [
        {
          "note": "Mr. Tom Support - Announcement Channel",
          "server_id": 781677817669877800,
          "channel_id": 875787516035350568
        },
        {
          "note": "Mr. Tom Support - Log Channel",
          "server_id": 781677817669877800,
          "channel_id": 961051641782628372
        }
      ],
      "title": "Title",
      "description": "Description"
    }
  ]
}

Sample 3

Send 2 simple embed to 1 channels

{
  "embeds": [
    {
      "send_to": [
        {
          "note": "Mr. Tom Support - Announcement Channel",
          "server_id": 781677817669877800,
          "channel_id": 875787516035350568
        }
      ],
      "title": "Title",
      "description": "Description"
    },
    {
      "send_to": [
        {
          "note": "Mr. Tom Support - Announcement Channel",
          "server_id": 781677817669877800,
          "channel_id": 875787516035350568
        }
      ],
      "title": "Title 2",
      "description": "Description 2"
    }
  ]
}