Placeholder reference
The placeholders Arclo's editors offer, by system and side by side. The editor for each field offers exactly the ones that field supports.
On this page
- General
- Activity reports
- Onboarding
- Welcome messages
- Welcome banners
- Goodbye messages
- Goodbye banners
- Level-up messages
- Level-up banners
- Level highlights
- Rank cards
- Achievement unlocks
- Almost there
- Achievement highlights
- Essentials
- Punishment announcements
- Punishment DMs
- Appeal decisions
- Report cards
- The reporter's DM
- Automatic report actions
- Invite join messages
- Invite leave messages
- Invite reward announcements
- Invite highlights
- Invite cards
- Ticket channel topics
- Management
- Starboard posts
- Statistics channel names
- Statistics channel goals
- Custom commands
- Utilities
- Embed messages
- Embed message responses
- Sticky messages
- Temporary voice channel names
- Temporary voice greetings
- Voice Linking notices
- Community
- Boost messages
- Boost banners
- Birthdays
- Birthday banners
- Tags
- Reminders
- Elsewhere
How placeholders behave (what happens to an unknown one, why a mention in an embed does not ping) is on Placeholders. This page is the list.
Tip
You do not have to memorize any of it. Type { in any field and the menu shows exactly what that field supports.
General
Activity reports
Server Analytics: the message a scheduled report rides in.
| Placeholder | Becomes |
|---|---|
{server} | Server name |
{server_icon} | Server icon URL |
{frequency} | Daily / Weekly / Monthly |
{period} | The window covered, e.g. "in the last 7 days" |
{send_schedule} | When the report goes out |
{member_count} | Current member count |
Onboarding
Welcome messages
Available in the channel message and the DM. The inviter placeholders are filled by Invite Tracking; with it off, or for an arrival it could not trace, they read as a stand-in rather than a gap.
| Placeholder | Becomes |
|---|---|
{user} | Mentions the member who joined |
{username} | The member's username |
{display_name} | The member's display name |
{user_id} | The member's Discord id |
{server} | The server name |
{member_count} | The server's member count, counting them |
{member_count_ordinal} | Their place in line, like "1250th" |
{account_age} | How old their Discord account is |
{account_created} | The date their account was created |
{joined_at} | When they joined this server |
{channel} | Mentions the welcome channel |
{avatar} | Member avatar URL, for icon fields |
{server_icon} | Server icon URL, for icon fields |
{inviter} | Mentions whoever invited them (needs Invite Tracking) |
{inviter_name} | The inviter's display name |
{inviter_invites} | How many invites the inviter now has |
{invite_code} | The invite code they used |
{invite_label} | The label you gave that invite link |
Welcome banners
Banner text is drawn, so mentions and live timestamps are not offered. There is nowhere for them to go.
| Placeholder | Becomes |
|---|---|
{username} | The member's username |
{display_name} | The member's display name |
{server} | The server name |
{member_count} | The server's member count, counting them |
{member_count_ordinal} | Their place in line, like "1250th" |
{account_age} | How old their Discord account is |
Goodbye messages
{member_count} is the count after they left, and there is no place-in-line twin: the 1249th member means nothing once somebody has gone.
| Placeholder | Becomes |
|---|---|
{user} | Mentions the member who left |
{username} | The member's username |
{display_name} | The member's display name |
{user_id} | The member's Discord id |
{server} | The server name |
{member_count} | Members left in the server |
{account_age} | How old their Discord account is |
{account_created} | The date their account was created |
{joined_at} | When they had joined (blank if unknown) |
{channel} | Mentions the goodbye channel |
{avatar} | Member avatar URL, for icon fields |
{server_icon} | Server icon URL, for icon fields |
Goodbye banners
| Placeholder | Becomes |
|---|---|
{username} | The member's username |
{display_name} | The member's display name |
{server} | The server name |
{member_count} | Members left in the server |
{account_age} | How old their Discord account is |
Level-up messages
Levels: the announcement when a member levels up.
| Placeholder | Becomes |
|---|---|
{user} | Mentions the member |
{username} | Their username |
{display_name} | Their display name in this server |
{avatar} | Their avatar image URL |
{level} | The level they just reached |
{previous_level} | The level they were on before |
{total_xp} | Their total XP |
{xp_to_next_level} | XP needed for the next level |
{rank} | Their position on the leaderboard |
{reward} | The role this level unlocked |
{banner} | The level-up banner image (image slots) |
{server} | The server name |
{server_icon} | The server icon URL |
{member_count} | How many members the server has |
{leaderboard_url} | Link to the web leaderboard |
Level-up banners
Text on the banner the level-up message carries.
| Placeholder | Becomes |
|---|---|
{display_name} | The member's display name |
{username} | The member's username |
{level} | The level they just reached |
{previous_level} | The level they were on before |
{rank} | Their place on the leaderboard |
{total_xp} | Their lifetime XP |
{message_count} | Messages they have sent |
{voice_time} | Time they have spent in voice |
{server} | The server name |
Level highlights
The weekly and monthly recap. {period} says which one it is.
| Placeholder | Becomes |
|---|---|
{leaderboard_image} | The top-10 board image (image slots) |
{leaderboard} | The formatted top-10 list, as text |
{period} | "Weekly" or "Monthly" |
{period_phrase} | "this week" or "this month" |
{ranked_by} | What the board ranks by: "XP", "Messages", "Voice time" or "Reactions" |
{top_member} | Mentions whoever placed first |
{server} | The server name |
{server_icon} | The server icon URL |
{leaderboard_url} | Link to the web leaderboard |
Rank cards
Text layers on the card /rank draws.
| Placeholder | Becomes |
|---|---|
{display_name} | The member's display name |
{username} | The member's username |
{level} | Their current level |
{rank} | Their place on the leaderboard |
{level_xp} | XP into the current level |
{level_xp_cost} | XP the current level costs |
{total_xp} | Their lifetime XP |
{message_count} | Messages they have sent |
{voice_time} | Time they have spent in voice |
{server} | The server name |
Achievement unlocks
Achievements: the unlock message.
| Placeholder | Becomes |
|---|---|
{user} | Mentions the member |
{username} | Their username |
{display_name} | Their display name |
{avatar} | Their avatar (image slots) |
{achievement} | The achievement's name |
{achievement_description} | Its description |
{tier} | The tier name, e.g. Silver |
{tier_goal} | What the tier required |
{progress} | Their progress towards it |
{unit} | What's being counted, e.g. messages |
{points_earned} | Points this unlock was worth |
{total_points} | Their total achievement points |
{unlocked_count} | How many they've unlocked |
{achievement_count} | How many the server has |
{reward} | Roles this tier handed over |
{banner} | The generated banner (image slots) |
{badge} | The badge image (image slots) |
{server} | Server name |
{server_icon} | Server icon (image slots) |
{member_count} | Member count |
{profile_url} | Link to their achievements page |
{list_url} | Link to the server's achievement list |
Almost there
The nudge for a member close to their next tier.
| Placeholder | Becomes |
|---|---|
{user} | Mentions the member |
{username} | Their username |
{display_name} | Their display name |
{avatar} | Their avatar (image slots) |
{achievement} | The achievement's name |
{achievement_description} | Its description |
{tier} | The tier they're closing in on |
{tier_goal} | What that tier requires |
{progress} | Where they are now |
{remaining} | How much is left |
{unit} | What's being counted, e.g. messages |
{percent} | Percent complete |
{badge} | The badge image (image slots) |
{server} | Server name |
{server_icon} | Server icon (image slots) |
{profile_url} | Link to their achievements page |
Achievement highlights
The weekly and monthly recap.
| Placeholder | Becomes |
|---|---|
{leaderboard_image} | The top-10 board image (image slots) |
{leaderboard} | The formatted top-10 list, as text |
{period} | "Weekly" or "Monthly" |
{period_phrase} | "this week" or "this month" |
{top_member} | Mentions whoever placed first |
{server} | The server name |
{server_icon} | The server icon URL |
{list_url} | Link to the public achievements list |
Essentials
Punishment announcements
Moderation: the public message posted in the channel. What is withheld by your privacy settings renders as a stand-in rather than as a gap.
| Placeholder | Becomes |
|---|---|
{target} | The punished member (mention) |
{target_tag} | Their username, as @name |
{target_id} | Their user id |
{moderator} | The moderator (mention) |
{moderator_tag} | The moderator's username, as @name |
{action_name} | What was done |
{action_phrase} | What was done, as a phrase |
{reason} | The reason given |
{duration} | How long it lasts |
{duration_note} | A duration line, blank when permanent |
{expires} | When it lifts (live countdown) |
{case_number} | The case number |
{server} | The server name |
{flagged_message} | The message it was about (when the channel may see it) |
{evidence} | The evidence the moderator attached (when the channel may see it) |
Punishment DMs
Sent to the member before the punishment lands, which is why the case number is not available here. It does not exist yet.
| Placeholder | Becomes |
|---|---|
{user} | The punished member (mention) |
{user_tag} | Their username, as @name |
{user_id} | Their user id |
{server} | The server name |
{moderator} | The moderator (mention) |
{moderator_tag} | The moderator's username, as @name |
{reason} | The reason given |
{action_name} | What was done |
{duration} | How long it lasts |
{expires} | When it lifts (live countdown) |
{warn_count} | How many warnings they now have |
{warning_points} | Their warning points |
{appeal_link} | Link to appeal, when appeals are on |
{new_nickname} | The new nickname |
{role} | The role involved |
{flagged_message} | The message it was about (when the DM may show it) |
{evidence} | The evidence the moderator attached (when the DM may show it) |
Appeal decisions
The DM a member gets when their appeal is approved or denied.
| Placeholder | Becomes |
|---|---|
{server} | The server name |
{case_number} | The case number that was appealed |
{reviewer_note} | The reviewer's note (“None” when there isn't one) |
{appeal_number} | The appeal's number |
Report cards
A custom design for the card a report posts in your staff channel.
| Placeholder | Becomes |
|---|---|
{report_number} | The report's number |
{target} | The reported member (mention) |
{target_tag} | Their username, as @name |
{reporter} | Who reported them (“Hidden” when reports are anonymous) |
{reason} | What the reporter said |
{server} | The server name |
The reporter's DM
Sent to whoever filed a report once it is closed.
| Placeholder | Becomes |
|---|---|
{user} | The reporter (mention) |
{report_number} | The report's number |
{target_tag} | The reported member, as @name |
{outcome} | "acted on" or "reviewed and closed" |
{server} | The server name |
Automatic report actions
The message the reported member gets from an automatic action's send them a message step.
| Placeholder | Becomes |
|---|---|
{user} | The reported member (mention) |
{user_tag} | Their username, as @name |
{server} | The server name |
{report_count} | How many members reported them |
{report_threshold} | The rung's threshold |
{reason} | The most recent report's reason |
Invite join messages
Invite Tracking. {inviter} and a few of its neighbors work in welcome messages too.
| Placeholder | Becomes |
|---|---|
{user} | Mentions the member who joined |
{display_name} | The joining member's display name |
{username} | Their username |
{user_id} | Their Discord id |
{user_avatar} | Their avatar URL, for icon and image fields |
{inviter} | Mentions the inviter (or "someone" when unknown) |
{inviter_name} | The inviter's display name |
{inviter_username} | The inviter's username |
{inviter_id} | The inviter's Discord id |
{inviter_avatar} | The inviter's avatar URL |
{inviter_invites} | The inviter's invite total after this join |
{inviter_regular} | The inviter's regular invites |
{inviter_left} | How many of the inviter's invites have since left |
{inviter_fake} | The inviter's fake invites |
{inviter_bonus} | The inviter's bonus invites |
{inviter_pending} | The inviter's invites still being validated |
{invite_code} | The invite code they used |
{invite_label} | The label you gave that invite link |
{invite_uses} | How many times that link has been used |
{invite_source} | How they got in: an invite link, the vanity URL, … |
{invite_note} | Why it didn't count, like fake or pending (blank on a clean join) |
{fake_reason} | Why it was fake: “New account” or “Rejoined” (blank when it counted) |
{account_age} | How old their Discord account is |
{member_count} | The server's member count, counting them |
{server} | The server name |
{server_icon} | Server icon URL, for icon fields |
{leaderboard_url} | Link to the server's invite leaderboard page |
Invite leave messages
The join message's set, less the link's live use count and the join note, plus how long they stayed.
| Placeholder | Becomes |
|---|---|
{user} | Mentions the member who joined |
{display_name} | The joining member's display name |
{username} | Their username |
{user_id} | Their Discord id |
{user_avatar} | Their avatar URL, for icon and image fields |
{inviter} | Mentions the inviter (or "someone" when unknown) |
{inviter_name} | The inviter's display name |
{inviter_username} | The inviter's username |
{inviter_id} | The inviter's Discord id |
{inviter_avatar} | The inviter's avatar URL |
{inviter_invites} | The inviter's invite total after this join |
{inviter_regular} | The inviter's regular invites |
{inviter_left} | How many of the inviter's invites have since left |
{inviter_fake} | The inviter's fake invites |
{inviter_bonus} | The inviter's bonus invites |
{inviter_pending} | The inviter's invites still being validated |
{invite_code} | The invite code they used |
{invite_label} | The label you gave that invite link |
{invite_source} | How they got in: an invite link, the vanity URL, … |
{fake_reason} | Why it was fake: “New account” or “Rejoined” (blank when it counted) |
{account_age} | How old their Discord account is |
{member_count} | The server's member count, counting them |
{server} | The server name |
{server_icon} | Server icon URL, for icon fields |
{leaderboard_url} | Link to the server's invite leaderboard page |
{time_in_server} | How long they stayed |
{joined_at} | When they originally joined |
Invite reward announcements
| Placeholder | Becomes |
|---|---|
{inviter} | Mentions the inviter who earned it |
{inviter_name} | Their display name |
{inviter_username} | Their username |
{inviter_avatar} | Their avatar URL |
{inviter_invites} | The invite total they reached |
{reward} | The role or roles they unlocked |
{server} | The server name |
{server_icon} | Server icon URL, for icon fields |
Invite highlights
The weekly and monthly recap.
| Placeholder | Becomes |
|---|---|
{leaderboard_image} | The top-10 board image (image slots) |
{leaderboard} | The formatted top-10 list, as text |
{period} | "Weekly" or "Monthly" |
{period_phrase} | "this week" or "this month" |
{top_member} | Mentions whoever placed first |
{server} | The server name |
{server_icon} | The server icon URL |
{leaderboard_url} | Link to the web leaderboard |
Invite cards
Text layers on the card /invites draws.
| Placeholder | Becomes |
|---|---|
{display_name} | The member's display name |
{username} | The member's username |
{invites} | Their invite total |
{rank} | Their place on the leaderboard |
{regular_invites} | Regular invites |
{left_invites} | Invited members who left |
{fake_invites} | Fake invites |
{bonus_invites} | Bonus invites |
{pending_invites} | Invites still being validated |
{joined_via} | How the member themselves joined |
{server} | The server name |
Ticket channel topics
Ticketing: the topic is written once, when the ticket opens, so nothing about claiming or closing is offered.
| Placeholder | Becomes |
|---|---|
{ticket_number} | Ticket number |
{user} | Opener, as a mention |
{username} | Opener's username |
{user_id} | Opener's ID |
{ticket_type} | Ticket type |
{panel_name} | Panel name |
{server} | Server name |
Management
Starboard posts
Starboards: the post a starred message becomes.
| Placeholder | Becomes |
|---|---|
{stars} | Star count |
{star_emoji} | Star emoji (tier-aware) |
{author} | Author mention |
{author_name} | Author display name |
{author_username} | Author username |
{author_avatar} | Author avatar URL |
{author_id} | Author user ID |
{content} | Original message text |
{channel} | Source channel mention |
{channel_name} | Source channel name |
{message_link} | Jump link to the original |
{message_id} | Original message ID |
{message_sent_at} | Original message time |
{server} | Server name |
{starboard} | Starboard name |
Statistics channel names
Statistics Channels: every counter's name template.
| Placeholder | Becomes |
|---|---|
{count} | The number, punctuated to your setting |
{raw_count} | The number with no punctuation |
{server} | This server's name |
{total_members} | Total members, for ratios like 120/1,250 |
Statistics channel goals
Offered once a counter has a goal set.
| Placeholder | Becomes |
|---|---|
{goal} | The target |
{remaining} | How many are left to reach it |
{percent} | Progress toward it |
{bar} | A progress bar |
Custom commands
Custom Commands. {uses} counts the run that is happening.
| Placeholder | Becomes |
|---|---|
{user} | Mentions the member who ran the command |
{username} | The member's username |
{display_name} | The member's display name |
{user_id} | The member's Discord id |
{server} | The server name |
{member_count} | The server's member count |
{channel} | Mentions the channel the command was used in |
{channel_name} | That channel's name |
{uses} | How many times this command has been used |
Utilities
Embed messages
The published message.
| Placeholder | Becomes |
|---|---|
{server} | The server name |
{channel} | Mentions the channel the message is posted in |
{member_count} | The server's member count |
{bot_avatar} | The bot's logo. For icon URL fields |
Embed message responses
The reply a button or dropdown on an embed message sends, where there is a member who clicked.
| Placeholder | Becomes |
|---|---|
{user} | Mentions the member who clicked |
{username} | The member's username |
{display_name} | The member's display name |
{user_id} | The member's Discord id |
{server} | The server name |
{channel} | Mentions the channel the message is posted in |
{member_count} | The server's member count |
{bot_avatar} | The bot's logo. For icon URL fields |
Sticky messages
| Placeholder | Becomes |
|---|---|
{server} | The server name |
{channel} | The channel it's stuck in |
{member_count} | The server's member count |
{repost_count} | How many times this sticky has been reposted |
{expires} | When it expires (live countdown, blank if it never does) |
{server_icon} | Server icon URL, for icon fields |
{bot_avatar} | Bot avatar URL, for icon fields |
Temporary voice channel names
Temporary Voice: the channel name, waiting room and text chat formats.
| Placeholder | Becomes |
|---|---|
{owner_username} | Owner's username |
{owner_nickname} | Owner's server nickname |
{channel_number} | Channel number (1, 2, 3…) |
{channel_number_padded} | Padded number (001, 002…) |
{channel_number_roman} | Roman numeral (I, II, III…) |
{channel_number_alpha} | Letter (A, B, C…) |
{privacy_emoji} | 🔓 / 🔒 / 👻 privacy icon |
{hub_name} | Hub name |
{server} | Server name |
Temporary voice greetings
The greeting and advertise messages.
| Placeholder | Becomes |
|---|---|
{owner_mention} | Mentions the channel owner |
{owner_username} | Owner's username |
{owner_nickname} | Owner's server nickname |
{channel} | Links the voice channel |
{hub_name} | Hub name |
{server} | Server name |
Voice Linking notices
The join and leave notices posted in a linked chat.
| Placeholder | Becomes |
|---|---|
{user_mention} | The member, as a mention |
{user} | The member, as a mention. The same thing, shorter |
{display_name} | Their display name |
{username} | Their username |
{user_id} | Their user ID |
{user_avatar} | Their avatar URL, for icon fields |
{channel} | The voice channel, as a link |
{channel_name} | The voice channel's name |
{voice_member_count} | How many people are in the voice channel now |
{server} | The server name |
{server_icon} | Server icon URL, for icon fields |
Community
Boost messages
| Placeholder | Becomes |
|---|---|
{user} | Mentions the booster |
{username} | The booster's username |
{display_name} | The booster's display name |
{user_id} | The booster's Discord id |
{server} | The server name |
{boost_count} | Total boosts on the server |
{boost_level} | The server's boost level (0–3) |
{member_count} | The server's member count |
{avatar} | Booster avatar URL, for icon fields |
{server_icon} | Server icon URL, for icon fields |
Boost banners
| Placeholder | Becomes |
|---|---|
{username} | The booster's username |
{display_name} | The booster's display name |
{server} | The server name |
{boost_count} | Total boosts on the server |
{boost_level} | The server's boost level (0–3) |
{member_count} | The server's member count |
Birthdays
{age} and {age_ordinal} stay blank without a birth year.
| Placeholder | Becomes |
|---|---|
{user} | Mentions the birthday member |
{username} | The member's username |
{display_name} | The member's display name |
{user_id} | The member's Discord id |
{server} | The server name |
{age} | The age they turn (blank without a birth year) |
{age_ordinal} | "21st" (blank without a birth year) |
{member_count} | The server's member count |
{avatar} | Member avatar URL, for icon fields |
{server_icon} | Server icon URL, for icon fields |
Birthday banners
| Placeholder | Becomes |
|---|---|
{username} | The member's username |
{display_name} | The member's display name |
{server} | The server name |
{age} | The age they turn (blank without a birth year) |
{age_ordinal} | "21st" (blank without a birth year) |
{member_count} | The server's member count |
Tags
| Placeholder | Becomes |
|---|---|
{user} | Mentions whoever used the tag |
{display_name} | Their display name |
{user_avatar} | Their avatar URL, for icon fields |
{target} | Mentions the member passed to the tag, else the user |
{target_name} | That member's display name |
{target_avatar} | That member's avatar URL |
{extra_text} | Whatever extra text was typed after the tag |
{channel} | The channel the tag was used in |
{server} | The server name |
{server_icon} | Server icon URL, for icon fields |
{member_count} | The server's member count |
{tag_name} | The tag's own name |
{use_count} | How many times the tag has been used |
{owner} | Mentions the tag's owner |
{created_at} | When the tag was made. A live relative time |
{bot_avatar} | Bot avatar URL, for icon fields |
Reminders
| Placeholder | Becomes |
|---|---|
{reminder_name} | The reminder's name |
{server} | The server name |
{user} | Mentions the DM target (blank for channel reminders) |
{date} | The delivery date, in the reminder's timezone |
{time} | The delivery time, in the reminder's timezone |
{next_run} | When it runs next (live countdown, blank on the last run) |
{member_count} | The server's member count |
{server_icon} | Server icon URL, for icon fields |
{bot_avatar} | Bot avatar URL, for icon fields |
Elsewhere
- [Social Alerts](/docs/social/overview): each platform has its own set, listed on its own page, plus the fallback-chain syntax
{title||description||New post}. - [Giveaways](/docs/management/giveaways), [Polls](/docs/utilities/polls), [Suggestions](/docs/community/suggestions) and [Ticketing](/docs/essentials/ticketing)'s messages each carry their own set, offered by the
{menu in the relevant editor. - [Automations](/docs/essentials/automations) offer what their trigger knows about, so the
{menu in a message action changes with the trigger you picked. - Command replies across Arclo have their own placeholders too, listed in each reply's editor on Command Info.
Still stuck? Ask in the support server: somebody there has almost certainly configured this before.