Embed Scripts - Celestia

Overview

Embed scripts use a special syntax to create rich, customized Discord embeds. This page explains the complete scripting system used in the ~embed create command.

All scripts support dynamic variables that automatically populate with real data when the embed is sent.

Basic Structure

Every embed must be wrapped in {embed} tags:

{embed}
$v{property: value}
{embed}

Components:

{embed} — Opening tag
$v{property: value} — Property declarations
{embed} — Closing tag

Property Syntax

Title

The main heading of your embed.Syntax:

$v{title: Your Title Here}

Examples:

$v{title: Welcome to the Server!}
$v{title: {user.mention} just joined}
$v{title: We now have {guild.count} members}

Limits: 256 characters max

Description

The main body text of your embed.Syntax:

$v{description: Your description text}

Examples:

$v{description: Thanks for joining {guild.name}!}
$v{description: Welcome! We're happy to have you here.}
$v{description: You are member #{guild.count}}

Limits: 4096 characters max

Color

Set the embed’s sidebar color.Syntax:

$v{color: hex_code_or_name}

Examples:

$v{color: #ff0000}
$v{color: blue}
$v{color: {random.color}}
$v{color: {user.color}}

Supported Formats:

Hex codes: #ff0000, #00ff00, #0099ff
Color names: red, blue, green, purple, pink, orange, yellow, etc.
Variables: {random.color}, {user.color}

Footer

Small text at the bottom of the embed.Syntax:

$v{footer: Footer text}
$v{footer_icon: image_url}

Or:

$v{footericon: image_url}

Examples:

$v{footer: Server Info}
$v{footer: Requested by {user}}
$v{footer_icon: {user.avatar}}
$v{footericon: {guild.icon}}

Limits: Footer text max 2048 characters

Author

Author section at the top of the embed.Syntax:

$v{author: Author name}
$v{author_icon: image_url}
$v{author_url: clickable_url}

Or:

$v{authoricon: image_url}
$v{authorurl: clickable_url}

Examples:

$v{author: {user.tag}}
$v{author_icon: {user.avatar}}
$v{author_url: {author.url}}

$v{author: {guild.name}}
$v{authoricon: {guild.icon}}

Limits: Author name max 256 characters

Images

Add visual elements to your embed.Syntax:

$v{thumbnail: image_url}
$v{image: image_url}

Examples:

$v{thumbnail: {user.avatar}}
$v{image: {guild.banner}}
$v{image: https://i.imgur.com/example.png}
$v{thumbnail: {guild.icon}}

Differences:

thumbnail — Small image on the right side
image — Large image at the bottom

URL

Make the embed title clickable.Syntax:

$v{url: https://example.com}

Examples:

$v{url: https://discord.com}
$v{url: {author.url}}
$v{url: https://celestia-bot-chi.vercel.app}

Note: Requires a title to be set

Timestamp

Add current timestamp to footer.Syntax:

$v{timestamp}

Example:

{embed}
$v{title: Server Info}
$v{timestamp}
{embed}

Note: No value needed, automatically uses current time

Fields

Add structured data in name-value pairs.Syntax:

$v{field: Name && Value && inline}

Examples:

$v{field: Member Count && {guild.count} && true}
$v{field: Owner && {guild.owner} && true}
$v{field: Created && {timestamp} && false}
$v{field: Status && Online && true}

Format:

Name — Field title (256 characters max)
Value — Field content (1024 characters max)
inline — true or false (displays side-by-side if true)

Limits: Maximum 25 fields per embed

Message

Add text content outside the embed.Syntax:

$v{message: Your message text}

Examples:

$v{message: Welcome {user.mention}!}
$v{message: Hey everyone, check this out!}
$v{message: {user.mention} just boosted the server!}

Note: Appears as regular text above the embed

Button Syntax

Add interactive buttons to your embeds using {button:} tags:

{button: label:Button Text && url:https://example.com && style:link}

Button Properties

Required:

label — Button text

Optional:

url — External link (for link buttons)
style — Button color/style
emoji — Button emoji
custom_id — Custom identifier
disabled — Makes button unclickable

Syntax:

{button: property:value && property:value}

Button Styles

Available button styles:

link — Blue button with external link (requires url)
primary — Blurple/purple button
secondary — Gray button
success — Green button
danger — Red button

Examples:

{button: label:Rules && url:https://example.com && style:link}
{button: label:Click Me && style:primary && emoji:🎉}
{button: label:Join && style:success}
{button: label:Leave && style:danger}

Button Examples

Link Button:

{button: label:Support Server && url:https://discord.gg/invite && style:link}

With Emoji:

{button: label:Verify && emoji:✅ && style:success}

Multiple Buttons:

{button: label:Rules && url:https://example.com/rules && style:link}
{button: label:Support && url:https://discord.gg/support && style:link && emoji:🎫}
{button: label:Website && url:https://example.com && style:link && emoji:🌐}

Limits: Maximum 5 buttons per row, 25 buttons total

Multiple Embeds

Create multiple embeds in one message:

{embed}
$v{title: First Embed}
$v{description: This is the first embed}
$v{color: red}
{embed}

{embed}
$v{title: Second Embed}
$v{description: This is the second embed}
$v{color: blue}
{embed}

Note: Separate each embed with {embed}{embed} tags

Complete Examples

{embed}
$v{title: Hello World}
$v{description: This is my first embed}
$v{color: blue}
{embed}

{embed}
$v{title: Welcome to {guild.name}!}
$v{description: Hi {user.mention}, thanks for joining!}
$v{color: green}
$v{thumbnail: {user.avatar}}
$v{footer: Member #{guild.count}}
$v{timestamp}
{embed}

{embed}
$v{title: Server Statistics}
$v{description: Current server information}
$v{color: #5865f2}
$v{field: Members && {guild.count} && true}
$v{field: Owner && {guild.owner} && true}
$v{field: Boosts && {guild.boost_count} && true}
$v{thumbnail: {guild.icon}}
$v{footer: Last updated}
$v{timestamp}
{embed}

{embed}
$v{title: Get Started}
$v{description: Click the buttons below!}
$v{color: purple}
{embed}
{button: label:Rules && url:https://discord.com && style:link}
{button: label:Support && url:https://discord.gg/support && style:link && emoji:🎫}
{button: label:Website && url:https://example.com && style:link && emoji:🌐}

{embed}
$v{message: Hey {user.mention}!}
$v{title: Server Rules}
$v{description: Please read and follow our rules}
$v{color: #ff0000}
$v{author: {guild.name}}
$v{author_icon: {guild.icon}}
$v{thumbnail: {guild.icon}}
$v{field: Rule 1 && Be respectful && false}
$v{field: Rule 2 && No spam && false}
$v{field: Rule 3 && Follow Discord TOS && false}
$v{footer: Last updated}
$v{timestamp}
$v{image: {guild.banner}}
{embed}
{button: label:Full Rules && url:https://example.com/rules && style:link}

{embed}
$v{title: Part 1}
$v{description: First section}
$v{color: red}
{embed}

{embed}
$v{title: Part 2}
$v{description: Second section}
$v{color: blue}
{embed}

{embed}
$v{title: Part 3}
$v{description: Third section}
$v{color: green}
{embed}

Tips & Best Practices

Script Writing Tips

Always close {embed} tags properly
Use $v{property: value} for all properties
Separate properties with newlines for readability
Test with ~embed preview before creating
Use variables to make embeds dynamic

Common Mistakes

Forgetting closing {embed} tag
Using wrong property names (e.g., colour instead of color)
Exceeding character limits
Invalid hex color codes
Missing && separator in fields and buttons

Variable SupportAll property values support dynamic variables. See the Variables guide for a complete list of available variables like {user.mention}, {guild.name}, {timestamp}, etc.

Character Limits

Property	Limit
Title	256 characters
Description	4096 characters
Field Name	256 characters
Field Value	1024 characters
Footer Text	2048 characters
Author Name	256 characters
Fields per Embed	25 max
Buttons per Row	5 max
Total Buttons	25 max

Syntax Reference

Property Format:

$v{property: value}

Field Format:

$v{field: Name && Value && true/false}

Button Format:

{button: label:Text && property:value}

Multiple Embeds:

{embed}..{embed}
{embed}..{embed}

Variables

Complete list of available variables

Embed Builder

Full embed builder command guide

Webhook

Send embeds through webhooks

Auto Responders

Use embeds in auto responses

​Overview

​Basic Structure

​Property Syntax

​Button Syntax

​Multiple Embeds

​Complete Examples

​Tips & Best Practices

​Character Limits

​Syntax Reference

​Related Resources

Variables

Embed Builder

Webhook

Auto Responders

Overview

Basic Structure

Property Syntax

Button Syntax

Multiple Embeds

Complete Examples

Tips & Best Practices

Character Limits

Syntax Reference

Related Resources