Placeholders
Every placeholder Buddy fills in, grouped by feature: welcome, level-up, starboard, boost, YouTube, stream, timed, auto responder, ticket and more.
On this page
- How placeholders work
- Mentioning a role, user or channel by ID
- Welcome messages
- Leave and invite messages
- Level-up messages
- Starboard
- Boost messages
- YouTube alerts
- Stream alerts
- Timed messages
- Auto responder
- Image-only channels
- Tickets
- Forum support
- Event timers
- Button roles
- /timestamp command
- Features without placeholders
- Related
Placeholders are words in {curly brackets} that Buddy swaps for real values when it posts a
message. {server} becomes your server's name, {user} becomes a mention of the member, and so
on. Each feature only understands its own set, so a placeholder that works in welcome messages may
show up as plain text somewhere else. Use this page to check what each feature supports.
How placeholders work#
- Type them exactly as shown, including the brackets. Most are all lowercase;
{oldLevel}and{boostLevel}have a capital L. - A placeholder a feature doesn't support stays in the message as plain text, so a typo is easy to spot.
- Mentions only notify people when the feature allows it. A mention inside an embed never sends a notification.
Mentioning a role, user or channel by ID#
Many features support these three ID tags:
| Placeholder | Becomes | Example |
|---|---|---|
{role:ROLE_ID} | A mention of that role | {role:123456789012345678} → @Members |
{user:USER_ID} | A mention of that user | {user:123456789012345678} → @Sam |
{channel:CHANNEL_ID} | A link to that channel | {channel:123456789012345678} → #rules |
To get an ID, turn on Developer Mode in Discord (User Settings → Advanced), then right-click the role, user or channel and choose Copy ID. Some dashboard pages have buttons or dropdowns that insert these tags for you.
Welcome messages#
Used in the welcome message, greetings, and everything in a Components layout: text, button labels, private replies, role menu text and image URLs.
| Placeholder | Becomes | Example |
|---|---|---|
{user} | A mention of the new member | @Alex |
{username} | Their username | alex_92 |
{displayname} | Their display name in your server | Alex |
{userid} | Their user ID | 123456789012345678 |
{greeting} | One of your greetings, picked at random | ✨ A wild Alex appeared! |
{server} | Your server name | Buddy Café |
{members} | Your member count (bots included) | 128 |
{membernumber} | Your member count as an ordinal | 128th |
{joined} | When they joined, as a relative time | just now |
{created} | When their account was created, as a relative time | 3 years ago |
{rules} | A link to your rules channel (empty if none is set) | #rules |
{everyone} | @everyone | @everyone |
{avatar} | A link to their avatar image | https://cdn.discordapp.com/… |
{servericon} | A link to your server icon (empty if you have none) | https://cdn.discordapp.com/… |
{role:ROLE_ID} {user:USER_ID} {channel:CHANNEL_ID} | Role, user and channel mentions | @Members |
In a button's Send a private reply text, the member placeholders describe the person who clicked the button, not the person who joined.
Leave and invite messages#
Leave messages and the join messages on the invite tracking page use a fixed format. They have no placeholders.
Level-up messages#
Used in the Message box of Level-up messages on the XP & levels page.
| Placeholder | Becomes | Example |
|---|---|---|
{user} | The member: a mention or their display name, depending on How to name the member | @Alex or Alex |
{level} | The level they just reached | 5 |
{oldLevel} | The level they were before | 4 |
{xp} | Their progress toward the next level, as XP into this level / XP needed | 120/450 |
Starboard#
Used in Post text on the Starboard page, or /starboard → Post message.
| Placeholder | Becomes | Example |
|---|---|---|
{user} | A mention of the message author | @Alex |
{channel} | The channel the message was posted in | #memes |
{count} | How many matching reactions it has | 5 |
{emoji} | The emoji that was used | ⭐ |
{starboard} | Your starboard's name | Hall of Fame |
{message_link} | A link to the original message (empty if the jump link is off) | https://discord.com/channels/… |
{role:ROLE_ID} | A mention of a role | @Starred |
Boost messages#
Used in the Message box of Boost message on the Boost messages page.
| Placeholder | Becomes | Example |
|---|---|---|
{user} | A mention of the member who boosted | @Alex |
{server} | Your server name | Buddy Café |
{boosts} | Your server's current boost count | 14 |
{boostLevel} | Your server's current boost level | 2 |
{everyone} | @everyone | @everyone |
{role:ROLE_ID} {user:USER_ID} {channel:CHANNEL_ID} | Role, user and channel mentions | #boosters |
With no message saved, Buddy posts: Thank you {user} for boosting {server}! We are now at {boosts} boosts (Level {boostLevel}).
YouTube alerts#
Used in the Message box of Notification message on the YouTube alerts page.
| Placeholder | Becomes | Example |
|---|---|---|
{author} | The YouTube channel's name | Buddy Gaming |
{title} | The video title | Top 10 Discord tips |
{url} | The video link. Include it so Discord shows the video preview. | https://www.youtube.com/watch?v=… |
{everyone} | @everyone | @everyone |
{role:ROLE_ID} | A mention of a role | @Video Pings |
{user:USER_ID} | A mention of a user | @Sam |
{channel:CHANNEL_ID} isn't supported in YouTube alerts.
Stream alerts#
Used in the Message box of Alert message on the Stream alerts page.
| Placeholder | Becomes | Example |
|---|---|---|
{user} | A mention of the member who went live | @Alex |
{name} | Their display name, without a mention | Alex |
{channel} | A link to the voice channel they're streaming in | 🔊 Gaming |
{server} | Your server name | Buddy Café |
With no message saved, Buddy posts {user} just went live in {channel}!. If you set a ping role,
its mention is added at the start.
Timed messages#
Used in the Message box on the Timed messages page.
| Placeholder | Becomes | Example |
|---|---|---|
{server} | Your server name | Buddy Café |
{members} | Your member count | 1287 |
{role:ROLE_ID} {user:USER_ID} {channel:CHANNEL_ID} | Role, user and channel mentions | @Events |
Auto responder#
Used in the Response box on the Auto responder page.
| Placeholder | Becomes | Example |
|---|---|---|
{author} | A mention of the member who said the trigger | @Alex |
{server} | Your server name | Buddy Café |
{members} | Your member count | 1287 |
{role:ROLE_ID} {user:USER_ID} {channel:CHANNEL_ID} | Role, user and channel mentions | #faq |
Image-only channels#
Used in the Reply message for an image-only channel on the Message filters page.
| Placeholder | Becomes | Example |
|---|---|---|
{author} | A mention of the member who posted | @Alex |
{server} | Your server name | Buddy Café |
{members} | Your member count | 1287 |
{role:ROLE_ID} {user:USER_ID} {channel:CHANNEL_ID} | Role, user and channel mentions | #chat |
Tickets#
Used in a ticket category's Automatic first reply on the Ticket system page.
| Placeholder | Becomes | Example |
|---|---|---|
{user} | A mention of the member who opened the ticket | @Alex |
{server} | Your server name | Buddy Café |
{everyone} | @everyone | @everyone |
{role:ROLE_ID} {user:USER_ID} {channel:CHANNEL_ID} | Role, user and channel mentions | @Support |
Forum support#
Used in the Content of Message in new threads on the Forum support page.
| Placeholder | Becomes | Example |
|---|---|---|
{user} | A mention of the member who created the thread | @Alex |
{server} | Your server name | Buddy Café |
{members} | Your member count | 1287 |
{role:ROLE_ID} {user:USER_ID} {channel:CHANNEL_ID} | Role, user and channel mentions | @Helpers |
Event timers#
Event timers have two fields with different placeholders.
Name template (the channel or category name):
| Placeholder | Becomes | Example |
|---|---|---|
{time} | The time left, in the units you chose | 2d 5h 30m |
If the name template has no {time}, the countdown is added to the end.
Embed message (posted when the event starts):
| Placeholder | Becomes | Example |
|---|---|---|
{time} | The event's date and time, shown in each reader's own timezone | Friday, October 24, 2026 8:00 PM |
{server} | Your server name | Buddy Café |
{members} | Your member count | 1287 |
{role:ROLE_ID} {user:USER_ID} {channel:CHANNEL_ID} | Role, user and channel mentions | @Events |
Button roles#
Used in the Message content of a button role message, or the
message option of /buttonrole.
| Placeholder | Becomes | Example |
|---|---|---|
{everyone} | @everyone | @everyone |
{role:ROLE_ID} {user:USER_ID} {channel:CHANNEL_ID} | Role, user and channel mentions | #roles |
/timestamp command#
The message option of /timestamp supports one placeholder.
| Placeholder | Becomes | Example |
|---|---|---|
{timestamp} | The date and time you entered, shown in each reader's timezone | Friday, October 24, 2026 8:00 PM |
If your message has no {timestamp}, the timestamp is added to the end.
Features without placeholders#
These post your text exactly as written: reaction roles (no text at all), XP bonus drops, the embed builder, announcements, and leave and invite messages.