> For the complete documentation index, see [llms.txt](https://discortics.com/llms.txt). A consolidated single-file corpus is available at [llms-full.txt](https://discortics.com/llms-full.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://discortics.com/guides/embeds.md).

# Messages and Embeds

Saved embeds are templates you can edit and send again.

## Before you begin

- You need **Manage Server**.
- In the destination channel, Discortics needs **View Channel**, **Send Messages**, and **Embed Links**.

## Create your first embed

### Dashboard Setup

1. Open **Dashboard → Embeds**.
2. Select **Create New Embed**.
3. Enter a name such as `Server Rules`.
4. Add a title and description, then choose a channel.
5. Save the embed.
6. Select **Send** and check the message in Discord.

### Discord Command Setup

1. Run `/settings embed`.
2. Select **New Embed**.
3. Set the name to `Server Rules`.
4. Select the channel.
5. Add a title and description.
6. Select **Create** to save it, then **Send**.

When asked for a value, reply within 60 seconds. Type `cancel` to keep the current value or `clear` to remove it.

## What you can add

| Part                    | Details                                                    | Limit            |
| ----------------------- | ---------------------------------------------------------- | ---------------- |
| **Name**                | The template name shown in menus                           |                  |
| **Channel**             | Where **Send** posts. Saving doesn't post                  |                  |
| **Content**             | Plain text above the embed                                 | 2,000 characters |
| **Title and URL**       | The URL makes the title clickable                          | 256 characters   |
| **Description**         | The main body. Supports Discord markdown                   | 4,000 characters |
| **Colour**              | Six-digit hex, such as `#5865f2`                           |                  |
| **Author**              | Name, icon URL, and link                                   |                  |
| **Thumbnail and Image** | Small top-right image and large image below the content    |                  |
| **Footer**              | Text and an optional icon URL                              |                  |
| **Timestamp**           | **Dynamic** uses the send time. **Static** uses a set time |                  |
| **Fields**              | Labelled blocks. **Inline** places them side by side       | 25 fields        |

Images and icons need direct `http://` or `https://` links. You can't upload files.

## Limits

| Resource     | Public | Prime | Custom |
| ------------ | -----: | ----: | -----: |
| Saved embeds |     20 |    50 |  1,000 |

The limit covers saved templates, not sends. When it's full, you can still send a draft without saving. One saved message holds one embed plus optional content.

If your server moves to a lower plan, only the oldest embeds within the limit stay available. They come back if you upgrade.

## Save, send, and delete

- **Create** saves a new template. **Save** updates one.
- **Send** posts the current draft and returns a link. The draft doesn't need to be saved.
- **Disable** hides a saved embed from other features' menus.
- **Export** shows the message as JSON in Discord.
- **Delete** removes the template after you confirm.

> [!WARNING]
> Deleting a template can't be undone. Messages already sent stay in Discord.

## Import a message

Available on the Dashboard.

1. Select **Import Existing Message**.
2. Paste a Discord message link or `CHANNELID-MESSAGEID`.
3. Select **Import**.
4. Edit the draft, then save it or send it.

The message must be in this server and visible to Discortics.

**Edit Original** appears when Discortics sent the original message, and updates it without reposting. Messages from members, webhooks, or other bots can't be edited.

## Welcome and leave messages

Saved embeds are separate from Welcome and Leave messages. Edit those in **Dashboard → Welcome** or with `/settings welcome` and `/settings leave`. See [Welcome, Leave, and Autoroles](/guides/welcome).

[Variables](/guides/welcome#variables) only work in Welcome and Leave messages. A normal send won't replace them.

## Commands

| Command           | What it does                   | Permission    |
| ----------------- | ------------------------------ | ------------- |
| `/settings embed` | Open the embed list and editor | Manage Server |

## Troubleshooting

**I can send but not save.** You've reached your saved-embed limit. Delete a template, upgrade, or send without saving.

**An image isn't showing.** Use a public, direct link to the image. A web page link won't work.

**I can't edit the imported original.** Only messages sent by Discortics can be edited. You can still import others as new drafts.

**The Discord editor stopped responding.** Run `/settings embed` again. Editor sessions last 30 minutes.

Prefer one-line commands? See [Direct Commands](/guides/command-arguments).
