Variables & Placeholders

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

Variable	Description
`{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

Variable	Description
`{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

Variable	Description
`{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

Variable	Description
`{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

Variable	Description
`{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)

Variable	Description
`{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

Variable	Description
`{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

Variable	Description
`{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

Variable	Description
`{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

Variable	Description
`{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

Variable	Description
`{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

Variable	Description
`{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

Variable	Description
`{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

Variable	Description
`{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

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

Using the Command

/placeholders

/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 Message
Server Info Embed
User Card
Moderation Log
Booster Thank You

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

{embed}
$v{title: {guild.name}}
$v{description: {guild.description}}
$v{thumbnail: {guild.icon}}
$v{field: Members && {guild.count} && true}
$v{field: Boosts && {guild.boost_count} (Tier {guild.boost_tier}) && true}
$v{field: Owner && {guild.owner_mention} && true}
{embed}

{embed}
$v{author: {user.tag}}
$v{author_icon: {user.avatar}}
$v{color: {user.color}}
$v{thumbnail: {user.avatar}}
$v{field: Joined && {user.joined_at_timestamp} && true}
$v{field: Roles && {user.roles_count} && true}
$v{field: Boosting && {user.boost} && true}
{embed}

{embed}
$v{title: Member Banned}
$v{description: {target_user.mention} was banned}
$v{field: Moderator && {moderator.mention} && true}
$v{field: Reason && {action.reason} && false}
$v{field: Case ID && {action.case_id} && true}
$v{color: ff0000}
$v{timestamp}
{embed}

Thank you {user.mention} for boosting {guild.name}!
We now have {guild.boost_count} boosts (Tier {guild.boost_tier})
Next goal: {boost.goal} boosts

Tips & Best Practices

Always test your variables

Use preview commands or test channels to ensure variables display correctly before going live.

Combine multiple variables

{user.mention} ({user.id}) joined as the {guild.member_count_ordinal} member

Creates rich, informative messages.

Use timestamps for better dates

{user.joined_at_timestamp}

Displays in user’s local timezone automatically.

Fallback for missing data

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

​Overview

​How to Use Variables

​User Basic Info

​User Avatar & Visual

​User Server Info

​User Roles & Permissions

​User Advanced

​Target User (Moderation)

​Moderator & Actions

​Server Basic Info

​Server Owner & Settings

​Server Boost & Features

​Server Limits & Special Channels

​Channel Counts

​Channel Info

​Time & Date

​Special Variables

​Using the Command

​Usage Examples

​Tips & Best Practices

​Related Features

Embed Builder

Welcome Messages

Auto Responders

Custom Replies

Overview

How to Use Variables

User Basic Info

User Avatar & Visual

User Server Info

User Roles & Permissions

User Advanced

Target User (Moderation)

Moderator & Actions

Server Basic Info

Server Owner & Settings

Server Boost & Features

Server Limits & Special Channels

Channel Counts

Channel Info

Time & Date

Special Variables

Using the Command

Usage Examples

Tips & Best Practices

Related Features