Overview
Variables (also known as placeholders) allow you to inject dynamic information into your Flare messages. When Flare sends a message, it automatically replaces the variable with the actual data at that exact moment. For example, if you use{user.mention} in a welcome message, Flare will replace it with an actual tag of the user who just joined: @Flame.
Why use Variables?
- Personalization: Makes automated messages feel tailored to the individual.
- Dynamic Embeds: Build complex profiles or info-panels that update automatically.
- Flexibility: Use them in Welcome Messages, Auto-Poster, Custom Commands, and more.
Variable Categories
Flare supports hundreds of variables, categorized logically based on what data they pull.User Variables
Information about the user triggering the action (e.g.,
{user.name}, {user.id}).Guild Variables
Information about the server (e.g.,
{guild.memberCount}, {guild.name}).Member Variables
Server-specific user info (e.g.,
{member.nickname}, {member.joinedAt}).Channel Variables
Data about the current text channel (e.g.,
{channel.name}, {channel.topic}).Role Variables
Data about specific roles (e.g.,
{role.color}, {role.members}).Time Variables
Formatted timestamps (e.g.,
{time.current}, {time.date}).Syntax & Usage
All variables in Flare must be wrapped in curly braces:{}.
Basic Example
In the Welcome module, you might set your welcome message to:Welcome to , ! We now have members.
Embed Variables
Variables aren’t just for text! You can use them inside Embed Builders on the dashboard.- Place
{user.avatarURL}inside the Thumbnail URL field to display the joining user’s profile picture. - Place
{guild.iconURL}in the Author Icon field.
Advanced: Conditionals & Logic
(Premium Feature) Flare Premium allows you to use basic logical statements inside your messages using the{{ }} syntax (coming soon in v2.4).
Troubleshooting
My variable is showing up as raw text (e.g., '{user.name}')
My variable is showing up as raw text (e.g., '{user.name}')
This happens if you misspell a variable, or if the variable doesn’t exist in the context you are using it. For example,
{role.name} will not work in a general welcome message because no specific role is involved in the event.The avatar URL is showing as text instead of an image
The avatar URL is showing as text instead of an image
If you are building an embed, ensure you paste
{user.avatarURL} into an Image URL or Thumbnail URL field on the dashboard, rather than the description field.