Custom Commands

Embed Builder

Design rich, formatted messages with colors, fields, images, and interactive elements.

Overview

Embeds are rich message objects in Discord that allow you to create visually appealing responses. Instead of plain text, embeds can include titles, descriptions, colored sidebars, fields, images, thumbnails, and footers.

Custom commands can return embeds alongside regular text. This makes your bot responses more professional, organized, and visually engaging for users.

Embed Components

Embeds consist of several customizable components:

Color Bar (Left Border)

A colored vertical bar on the left side of the embed. Helps identify the embed at a glance. Can be any hex color.

Title

The main heading of the embed. Appears at the top in bold text. Can include links by using markdown.

Description

Main content area below the title. Supports markdown formatting like bold, italic, code blocks, and links.

Fields

Structured data displayed in columns. Each field has a name and value. Can be displayed side-by-side (inline) or stacked.

Image

Large image displayed below description and fields. Must be a valid image URL (jpg, png, gif, webp).

Thumbnail

Small square image in the top-right corner of the embed. Good for logos or avatars.

Author

Small section above title with author name and optional icon. Great for crediting sources or bots.

Footer

Text at the bottom of the embed. Usually shows timestamp or additional info. Can include a small icon.

Configurable Properties

These properties can be customized when creating an embed:

`Color`	Hex color code	#FF5733	Left border of embed
`Title`	Main heading	Server Info	Appears at top
`Title URL`	Link for title	https://discord.gg/...	Makes title clickable
`Description`	Main text content	Long description...	Below title, markdown support
`Thumbnail URL`	Small image	https://imgur.com/...	Top-right corner
`Image URL`	Large image	https://imgur.com/...	Below description
`Author Name`	Credit line	SYNTHET Bot	Above title (small)
`Author Icon`	Author image	https://imgur.com/...	Next to author name
`Footer Text`	Bottom text	Created at {now}	Bottom of embed
`Footer Icon`	Footer image	https://imgur.com/...	Next to footer
`Field Name`	Column header	Members	Bold field label
`Field Value`	Column content	245 active	Field content text
`Field Inline`	Side-by-side?	true/false	Arrange horizontally

Embed Colors

Embeds use a colored bar on the left side. Here are common colors:

Red

#FF0000

Orange

#FF8C00

Yellow

#FFD700

Green

#00FF00

Blue

#0000FF

Purple

#9933FF

Pink

#FF1493

Cyan

#00FFFF

Lime

#32CD32

Indigo

#4B0082

Gold

#FFB300

Gray

#808080

Basic Embed Example

Here's how to create a simple embed in the command builder:

Configuration

• Title: "Server Information"
• Color: "#5865F2" (Discord Blue)
• Description: "Get details about our server"

Result

Server Information

Get details about our server

Working with Fields

Fields organize information in a structured format:

Stacked Fields (Default)

Fields appear one per row. Each field takes full width.

Members: 245 active

Owner: AdminUser

Created: 2019-03-10

Inline Fields (Side-by-Side)

When marked inline, fields appear next to each other (up to 3 per row).

Level

12,500

Role

Admin

Complex Embed Examples

More advanced embed configurations for real-world scenarios:

User Profile Card

• Color: #5865F2

• Author: {user}

• Thumbnail: {user_avatar}

• Description: User statistics and info

• Fields (inline): Level | XP | Rank | Join Date

• Footer: Created at {now}

Shows a profile card with user info and stats in a compact format

Rules/Guidelines

• Color: #FF8C00 (Orange)

• Title: "Community Guidelines"

• Description: Introduction text

• Fields (stacked): Rule 1 | Rule 2 | Rule 3...

• Footer: Last updated {date}

Structured rules with clear numbering and descriptions

Status Report

• Color: #00FF00 (Green) or #FF0000 (Red)

• Title: "Bot Status"

• Fields (inline): Uptime | Ping | Guilds | Users

• Image: Status graph or dashboard screenshot

• Footer: Auto-updated

System metrics displayed with compact inline fields

Event Announcement

• Color: #9933FF (Purple)

• Title: "🎉 Server Event"

• Thumbnail: Event logo or icon

• Description: Event description with details

• Fields: Date | Time | Location | Registration

• Image: Event banner

Rich announcement with multiple media and structured info

Text Formatting in Embeds

Embeds support Discord's markdown formatting:

`bold text`	Makes text bold	Server Name
`__underline__`	Underlines text	__Important__
`italic text`	Makes text italic	Please read
`~~strikethrough~~`	Crosses out text	~~Old rule~~
`inline code`	Monospace inline	`/command help`
```code block```	Multi-line code	``` code here ```
`[link text](url)`	Clickable link	[Discord](https://discord.gg)
`:emoji_name:`	Embed emojis	:star: Great job!

Using Images in Embeds

Guidelines for embedding images:

Image Formats

Supported: JPG, PNG, GIF (animated), WebP. Use direct image URLs or imgur.com links.

Image URLs

Use full URLs: https://imgur.com/image.jpg or https://cdn.example.com/image.png

https://imgur.com/abcdef.jpg

Thumbnail vs Image

• Thumbnail: Small (72x72) icon in top-right
• Image: Large (full-width) at bottom of embed

User Avatars

Use {user_avatar} variable to automatically insert the user's profile picture.

Embed Limits

Discord has size and content limits for embeds:

Title: 256 characters max

Description: 4,096 characters max

Fields: Up to 25 fields per embed

Field Name: 256 characters max

Field Value: 1,024 characters max

Total: 6,000 characters per embed

Footer: 2,048 characters max

Tips & Best Practices

• Choose colors that match your server's branding or theme
• Use inline fields for quick stats (3 fields per row max)
• Keep descriptions concise and scannable
• Use footers to show timestamps or credit the bot
• Thumbnails work great for user avatars and logos
• Test embeds in your server to see how they look
• Avoid embedding huge blocks of text - use fields instead
• Use the image field for charts, graphs, or banners
• Combine variables like {user} and {now} for dynamic content
• Keep total embed size under 6,000 characters
• Use bold formatting (**text**) to highlight important info
• Include emojis in titles and fields for visual appeal

Variables Reaction Roles