Skip to main content

​
Overview

Variables (also called placeholders) are dynamic codes you can use throughout Celestia to display real-time information. Wrap them in curly braces like {user.mention} to use them in embeds, welcome messages, auto-responders, and more.
All variables update automatically with current information when messages are sent.

​
How to Use Variables

Variables work in:
  • Welcome & Goodbye messages
  • Custom embeds
  • Auto-responders
  • Vanity tracking
  • Custom command replies
  • Moderation logs
Example: 
Welcome {user.mention} to {guild.name}! You're member #{guild.count}
Output: 
Welcome @John to My Server! You're member #1,234

​
User Basic Info

VariableDescription
{user}The username of the user
{user.tag}The full tag (username#discriminator)
{user.mention}Mentions the user
{user.id}The user’s ID
{user.display_name}User’s display name
{user.nickname}User’s server nickname (or ‘None’)
{user.discriminator}User’s discriminator (or ‘0’)
{user.bot}Returns ‘true’ if user is a bot
{user.created_at}When the user account was created
{user.created_at_timestamp}Account creation timestamp

​
User Avatar & Visual

VariableDescription
{user.avatar}User avatar (dynamic URL)
{user.avatar_static}User avatar (non-animated)
{user.display_avatar}User display avatar URL
{user.guild_avatar}Server-specific avatar
{user.banner}User banner URL (if any)
{user.accent_color}User accent color in hex
{user.avatar_decoration}User’s avatar decoration
{user.color}User’s role color in hex
{user.top_role}User’s highest role name
{user.highest_role_color}Highest role color in hex

​
User Server Info

VariableDescription
{user.joined_at}When user joined the server
{user.joined_at_timestamp}Join date as Discord timestamp
{user.join_position}User’s join position (1, 2, 3…)
{user.join_position_suffix}Join position with suffix (1st, 2nd, 3rd)
{user.boost}Returns ‘true’ if user is boosting
{user.boost_since}When user started boosting
{user.boost_since_timestamp}Boost start timestamp
{user.pending}Returns ‘true’ if user is pending
{user.timeout}When user timeout ends (if any)
{user.stayduration}How long user has been in server

​
User Roles & Permissions

VariableDescription
{user.role_list}List of user roles (mentions)
{user.role_text_list}List of user roles (names)
{user.roles_mention}User roles as mentions
{user.roles_count}Number of roles user has
{user.highest_role_id}User’s highest role ID
{user.permissions}List of user permissions
{user.is_owner}Returns ‘true’ if user is server owner
{user.voice_channel}User’s current voice channel
{user.status}User’s online status
{user.activity}User’s current activity

​
User Advanced

VariableDescription
{user.flags}User flags (badges)
{user.public_flags}User public flags
{user.locale}User’s locale setting
{user.premium_type}User’s Nitro type (None, Classic, Nitro, Basic)

​
Target User (Moderation)

VariableDescription
{target_user.id}Target user ID
{target_user.mention}Mention target user
{target_user.name}Target username
{target_user.tag}Target user tag
{target_user.avatar}Target user avatar
{target_user.created_at}Target account creation date

​
Moderator & Actions

VariableDescription
{moderator}Moderator username
{moderator.mention}Mention the moderator
{moderator.id}Moderator ID
{action.reason}Moderation action reason
{action.case_id}Moderation case ID
{action.duration}Action duration (e.g. timeout)
{custom.reason}Custom reason field

​
Server Basic Info

VariableDescription
{guild.name}Server name
{guild.id}Server ID
{guild.icon}Server icon URL
{guild.banner}Server banner URL
{guild.splash}Server invite splash URL
{guild.description}Server description
{guild.vanity_url}Server vanity URL code
{guild.count}Total member count
{guild.member_count_ordinal}Member count with suffix (1,234th)
{guild.owner_id}Server owner ID

​
Server Owner & Settings

VariableDescription
{guild.owner}Server owner username
{guild.owner_mention}Mention server owner
{guild.created_at}When server was created
{guild.region}Server preferred locale
{guild.shard}Server shard ID
{guild.large}Returns ‘true’ if large server
{guild.verification_level}Server verification level (0-4)
{guild.explicit_content_filter}Content filter level
{guild.mfa_level}2FA requirement level
{guild.nsfw_level}NSFW level

​
Server Boost & Features

VariableDescription
{guild.boost_count}Number of boosts
{guild.boost_tier}Server boost tier (0-3)
{server.boosts}Same as boost_count
{boost.goal}Next boost goal
{guild.emoji_count}Number of emojis
{guild.sticker_count}Number of stickers
{guild.role_count}Number of roles
{guild.key_features}List of server features
{guild.discovery}Returns ‘true’ if discoverable
{guild.verification_required}Returns ‘true’ if verification needed

​
Server Limits & Special Channels

VariableDescription
{guild.max_presences}Max presence count
{guild.max_members}Max member count
{guild.max_video_channel_users}Max video channel users
{guild.afk_timeout}AFK timeout duration
{guild.afk_channel}AFK channel name
{guild.system_channel}System messages channel
{guild.rules_channel}Rules channel
{guild.public_updates_channel}Community updates channel
{guild.preferred_locale}Server preferred language

​
Channel Counts

VariableDescription
{guild.channels_count}Total number of channels
{guild.text_channels}List of text channels
{guild.text_channels_count}Number of text channels
{guild.voice_channels}List of voice channels
{guild.voice_channels_count}Number of voice channels
{guild.stage_channels}List of stage channels
{guild.stage_channels_count}Number of stage channels
{guild.forum_channels}List of forum channels
{guild.forum_channels_count}Number of forum channels
{guild.category_channels}List of categories
{guild.category_channels_count}Number of categories
{guild.thread_count}Total number of threads

​
Channel Info

VariableDescription
{channel}Mentions the channel
{channel.name}Channel name
{channel.id}Channel ID
{channel.mention}Channel mention
{channel.type}Channel type (0=text, 2=voice, etc)
{channel.position}Channel position in list
{channel.topic}Channel topic/description
{channel.category_id}Parent category ID
{channel.category_name}Parent category name
{channel.slowmode_delay}Slowmode delay in seconds
{channel.nsfw}Returns ‘true’ if NSFW channel
{channel.created_at}When channel was created
{channel.url}Direct URL to channel
{channel.members_count}Members in voice channel
{channel.last_message_id}Last message ID

​
Time & Date

VariableDescription
{time}Relative time (e.g. “5 minutes ago”)
{time.short}Short time format (e.g. 3:45 PM)
{time.long}Long time format (e.g. 3:45:30 PM)
{timestamp}Full date and time
{date}Date only (e.g. 12/25/2024)
{unix}Unix timestamp (seconds since epoch)

​
Special Variables

VariableDescription
{author.url}Link to user Discord profile
{random.color}Random hex color code
{vanity}Vanity URL being tracked

​
Using the Command

/placeholders
What It Shows:
  • Interactive paginated list
  • All 140+ variables organized by category
  • Navigation buttons
  • Jump to page feature
  • Search within categories
Features:
  • 14 pages of variables
  • 10 variables per page
  • Previous/Next navigation
  • Jump to any page
  • 2-minute timeout

​
Usage Examples

Welcome {user.mention} to {guild.name}!
You're our {guild.member_count_ordinal} member.
Account created: {user.created_at}
Output:
Welcome @John to My Server!
You're our 1,234th member.
Account created: Jan 15, 2024

​
Tips & Best Practices

Use preview commands or test channels to ensure variables display correctly before going live.
{user.mention} ({user.id}) joined as the {guild.member_count_ordinal} member
Creates rich, informative messages.
{user.joined_at_timestamp}
Displays in user’s local timezone automatically.
Some variables return “None” or “Unknown” if data isn’t available. Design messages to handle this gracefully.

Embed Builder

Use variables in custom embeds

Welcome Messages

Set up automated welcome messages with variables

Auto Responders

Use variables in automatic responses

Custom Replies

Customize command responses with variables