Global Placeholders
Features
- Use bot identity, server info, and timestamps as placeholders in any customizable message - replaced automatically when the message is sent.
- Use live ticket metrics (utilization, estimated wait time) in ticket opening messages, welcome messages, statistics channel names, and more.
- Show per-topic metrics to give users specific information about the topic they selected.
- Placeholders update automatically based on real-time data.
Setup
- Bot, server, timestamp, and opening-hours placeholders are always available - no configuration required.
- For ticket metric placeholders: enable Ticket Utilization and/or Estimated Wait Time in your dashboard.
- Use the placeholders below in any customizable message field (ticket opening messages, welcome messages, statistics channel names, etc.).
Not every placeholder is available in every context. Bot, server, timestamp, and opening-hours placeholders work in any customizable message. Ticket metric placeholders work in ticket opening messages, welcome messages, utilization/EWT messages, and statistics channels. Feature-specific placeholders (for example %staffUser% or %estimatedWaitTime%) are only available in the messages documented on their respective feature pages.
Available placeholders
Bot
| Placeholder | Description |
|---|---|
%botName% | Display name of the bot. |
%botID% | User ID of the bot. |
%botAvatar% | Avatar URL of the bot. |
%botTag% | Full tag of the bot. |
%botMention% | Mention string of the bot (e.g. <@123...>). |
Server
| Placeholder | Description |
|---|---|
%guildName% | Name of the server. |
%guildID% | ID of the server. |
%guildIcon% | Icon URL of the server. |
Timestamps
Timestamp placeholders use Discord's native timestamp formatting and automatically adapt to each user's timezone and locale. They are evaluated at the moment the message is sent.
| Placeholder | Discord Style | Description |
|---|---|---|
%timestamp% | f | Short date/time (same as %shortDateTime%). |
%shortTime% | t | Short time (e.g. 4:20 PM). |
%longTime% | T | Long time (e.g. 4:20:30 PM). |
%shortDate% | d | Short date (e.g. 04/05/2026). |
%longDate% | D | Long date (e.g. April 5, 2026). |
%shortDateTime% | f | Short date/time. |
%longDateTime% | F | Long date/time. |
%relativeTime% | R | Relative time (e.g. "just now" or "2 minutes ago"). |
Opening hours
| Placeholder | Description |
|---|---|
%openingHours% | A formatted representation of your configured opening hours. Empty if opening hours are not configured. |
Global metrics
These placeholders show metrics across all tickets in the system.
| Placeholder | Description |
|---|---|
%globalUtilization% | The current ticket utilization as a formatted percentage (e.g. "75%").RequirementRequires Ticket Utilization to be enabled. |
%globalUtilizationCount% | The number of currently open tickets.RequirementRequires Ticket Utilization to be enabled. |
%globalUtilizationEmoji% | A visual indicator emoji based on the current utilization level (green circle, yellow circle, or red circle).RequirementRequires Ticket Utilization to be enabled. |
%globalEstimatedWaitTime% | The estimated wait time as a formatted duration (e.g. "15 minutes").RequirementRequires Estimated Wait Time to be enabled. |
%globalEstimatedWaitTimeMinutes% | The estimated wait time as a number in minutes.RequirementRequires Estimated Wait Time to be enabled. |
Per-topic metrics
These placeholders show metrics for a specific ticket topic. Replace {topicID} with the unique ID of the topic.
| Placeholder | Description |
|---|---|
%topicUtilization-{topicID}% | The utilization percentage for the specified topic.RequirementRequires Ticket Utilization to be enabled and the topic to have utilization enabled. |
%topicUtilizationCount-{topicID}% | The number of currently open tickets for the specified topic.RequirementRequires Ticket Utilization to be enabled and the topic to have utilization enabled. |
%topicUtilizationEmoji-{topicID}% | A visual indicator emoji for the specified topic's utilization level.RequirementRequires Ticket Utilization to be enabled and the topic to have utilization enabled. |
%topicEstimatedWaitTime-{topicID}% | The estimated wait time for the specified topic as a formatted duration.RequirementRequires Estimated Wait Time to be enabled. |
%topicEstimatedWaitTimeMinutes-{topicID}% | The estimated wait time for the specified topic in minutes.RequirementRequires Estimated Wait Time to be enabled. |
If a placeholder's required feature is not enabled or no data is available, the placeholder resolves to "Not available".
Where to use them
Bot, server, timestamp, and opening-hours placeholders can be used in any customizable message field (the examples below also apply to them).
Ticket metric placeholders can be used in:
- Ticket opening messages - show users the current queue status before they open a ticket.
- Welcome messages - inform users about expected wait times when their ticket is created.
- Statistics channel names - display live metrics in voice channel names (updated every 15 minutes).
- Utilization messages - enrich utilization warnings with specific numbers.
- Estimated wait time messages - combine global and topic-specific wait times.
When a message template receives both global placeholders and its own feature-specific placeholders (like %topic% or %userID%), the feature-specific placeholders take priority if there is a name collision.