Getting Started
Placeholders
A placeholder is a word in curly brackets, like {server}, that Sparrow swaps for the real thing when it sends a message. Write "Welcome to {server}!" once and every member sees your server's name.
Using them
- On the dashboard, each editor lists the placeholders it understands. Click one to copy it, then paste it where you want it.
- They work anywhere in a message: the text above an embed, the title, description, fields, footer, image links, and every part of a Components V2 message.
- The live preview shows them filled in with example or real details.
- Each place understands its own list, below. One it doesn't know, or a typo, is left exactly as you typed it, so you'll spot it.
Times and dates
In Messages, {timestamp(...)} puts a time in the message. You write it in your own time zone, and everyone sees it in theirs, so 23:00 for you might read 1:00 AM for someone else. Sparrow gets your time zone from your browser when you post.
| You type | Everyone sees (in their own time zone) |
|---|---|
{timestamp(23:00)} | Today at 23:00 your time, like 11:00 PM |
{timestamp(11:30 pm)} | The same, written with am or pm |
{timestamp(2026-10-05 19:30)} | That day and time, like October 5, 2026 at 7:30 PM |
{timestamp(23:00, relative)} | How long until then, like "in 3 hours", counting down |
{timestamp(23:00, date)} | Just the date. Use time or full for just the time, or both |
{date} | The day you post it |
Discord can't show these in an embed title, author name, footer, field name or button label. There, Sparrow writes the time out with your time zone instead, like "11:00 PM MDT".
Messages
Messages you post from the dashboard. They aren't about one member, so only the server's details work here. They're filled in when you press Post or update the message, so a count is the count at that moment.
| Placeholder | Becomes |
|---|---|
{server} | The server's name |
{membercount} | How many members the server has |
{servericon} | The server's icon. Use it as an image or thumbnail link |
{boostcount} | How many boosts the server has |
{boosttier} | The server's boost level, 0 to 3 |
{date} | The day you post it, in each reader's own time zone |
{servercreated} | The day the server was made |
{timestamp(23:00)} | A time in your time zone that everyone sees in theirs. See Times and dates |
Tickets
A ticket panel's welcome message and its Application Mode DM. The member is whoever opened the ticket. In Application Mode, {user} in the welcome message is their name in bold, since a mention would add them to the ticket before you invite them.
| Placeholder | Becomes |
|---|---|
{user} | Mentions the member who opened it |
{username} | Their Discord username |
{displayname} | Their nickname in the server, or their name |
{userid} | Their Discord ID |
{avatar} | Their avatar. Use it as an image or thumbnail link |
{server} | The server's name |
{membercount} | How many members the server has |
{ticketnumber} | The ticket's number on this panel |
{panel} | The panel's name |
{answer1}{answer2}... | Their answer to question 1, question 2, and so on. Empty if they skipped it |
Ticket close DM
The DM the member who opened a ticket gets when it closes, set on the panel's Close Options tab. The same as Tickets, without the answers, plus:
| Placeholder | Becomes |
|---|---|
{ticketname} | The ticket's channel or thread name |
{opendate} | When the ticket was opened, in each reader's own time |
{closedate} | When it was closed, in each reader's own time |
{closedby} | Mentions whoever closed it |
{closereason} | The reason given when it was closed, or "No reason given" |
Accepted and Denied DMs
The DMs the member who opened a ticket gets when staff press Approve or Deny, set on the panel's Messages tab. The same as Tickets, plus:
| Placeholder | Becomes |
|---|---|
{reason} | What staff wrote when they decided, or "No additional comments." |
{decidedby} | Mentions who pressed Approve or Deny |
Approved and Denied DMs (Applications)
The DMs an applicant gets when their application is approved or denied, set on the application panel's Messages tab. The member and server ones, plus:
| Placeholder | Becomes |
|---|---|
{panel} | The application panel's name |
{reason} | What staff wrote when they decided, or a short line saying there was none |
{decidedby} | Mentions who approved or denied it |
{roles} | "You've been given: @Role" when the decision gave roles, otherwise nothing |
Welcome & Goodbye
Welcome, goodbye, milestone and welcome DM messages. In a goodbye, {user} is their name in bold, since they've left. With "ping the member" turned off, it's their name in bold too.
| Placeholder | Becomes |
|---|---|
{user} | Mentions the member |
{username} | Their Discord username |
{displayname} | Their nickname in the server, or their name |
{userid} | Their Discord ID |
{avatar} | Their avatar. Use it as an image or thumbnail link |
{accountcreated} | When their Discord account was made, like "3 years ago" |
{server} | The server's name |
{membercount} | How many members the server has |
{servericon} | The server's icon. Use it as an image or thumbnail link |
{boostcount} | How many boosts the server has |
{boosttier} | The server's boost level, 0 to 3 |
{membercount_ordinal} | The member count as a place, like 152nd |
Boost Messages
The message sent when someone boosts. The same placeholders as Welcome & Goodbye.
| Placeholder | Becomes |
|---|---|
{user} | Mentions the member |
{username} | Their Discord username |
{displayname} | Their nickname in the server, or their name |
{userid} | Their Discord ID |
{avatar} | Their avatar. Use it as an image or thumbnail link |
{accountcreated} | When their Discord account was made, like "3 years ago" |
{server} | The server's name |
{membercount} | How many members the server has |
{servericon} | The server's icon. Use it as an image or thumbnail link |
{boostcount} | How many boosts the server has |
{boosttier} | The server's boost level, 0 to 3 |
Auto Responders
Replies to a message that matched. The member is whoever sent it.
| Placeholder | Becomes |
|---|---|
{user} | Mentions the member. Their name in bold if notifying is off |
{username} | Their username |
{displayname} | Their nickname in the server, or their name |
{channel} | The channel they posted in |
{server} | The server's name |
{membercount} | How many members the server has |
{avatar} | Their avatar. Use it as an image or thumbnail link |
{servericon} | The server's icon. Use it as an image or thumbnail link |
Sticky Messages
A sticky message isn't about one member, so only the server and channel.
| Placeholder | Becomes |
|---|---|
{server} | The server's name |
{membercount} | How many members the server has |
{channel} | The channel the sticky is in |
{servericon} | The server's icon. Use it as an image or thumbnail link |
Leveling
The level up message.
| Placeholder | Becomes |
|---|---|
{user} | Mentions the member |
{displayname} | Their nickname in the server, or their name |
{level} | Their new level |
{nextlevel} | The level after that |
{xpneeded} | XP they still need for the next level |
{xp} | Their total XP |
{role} | The reward role they just got (empty if none) |
{rolename} | That role's name, without a mention |
{server} | The server's name |
{avatar} | Their avatar. Use it as an image or thumbnail link |
Reviews
The review request DM sent after a ticket or application.
| Placeholder | Becomes |
|---|---|
{subject} | The panel's name |
{opener} | Who opened the ticket or applied |
{handler} | Who helped: the claimer, or whoever closed it if nobody claimed it (tickets only) |
{server} | The server's name |
Giveaways
The entry button's label.
| Placeholder | Becomes |
|---|---|
{count} | How many entries so far, bonus entries included, like 12 |
{players} | How many people entered, like "12 players" |
Custom ticket names
On a ticket panel's Advanced tab, turn on Custom Ticket Name and drag these in to build the name. Discord lowercases channel names and turns spaces into dashes. Up to 3 parts are free; more need Premium.
| Piece | Becomes |
|---|---|
Panel Name | The panel's name |
User ID | The member's Discord ID |
Username | Their Discord username |
User Display Name | Their nickname or name |
Server Name | The server's name |
Ticket Number | The ticket's number, counting up |
Created Date | The day it opened, like 2026-09-30 |
Names from other bots
Moving from another bot? In Tickets, Welcome & Goodbye and Boost messages, Sparrow also understands the names other bots use, so text you copy over keeps working.
| Other names | Same as |
|---|---|
{member.mention}{user_mention}{mention} | {user} |
{member.username}{member.name}{user_name} | {username} |
{member.displayname}{member.nickname}{nickname} | {displayname} |
{member.id}{user_id} | {userid} |
{ticket.number}{ticket_number} | {ticketnumber} |
{panel.name}{panel_name} | {panel} |
{guild.name}{server_name} | {server} |
{guild.memberCount}{server_members} | {membercount} |
{user_position} | {membercount_ordinal} |
{member.avatar}{user_avatar} | {avatar} |
{guild.icon}{server_icon} | {servericon} |
{guild.premiumSubscriptionCount}{boost_count} | {boostcount} |
{guild.premiumTier}{boost_level} | {boosttier} |