Overview
Welcome messages let you automatically greet new members the moment they join your server. You can configure rich embeds with dynamic variables that pull in the member’s name, avatar, join position, and more. Messages can be sent to any channel, and you can set up multiple welcome messages across different channels simultaneously.
pom uses an embed scripting system that gives you full control over the message appearance — titles, descriptions, colors, images, footers, buttons, and even self-destructing messages that auto-delete after a set time.
The default prefix is ,. All examples below use this prefix.
Setting Up a Welcome Message
,welcome add <channel> <message>
| Parameter | Type | Required | Description |
|---|
channel | Channel mention | Yes | The channel where the welcome message will be sent |
message | Embed script | Yes | The message content using embed scripting syntax |
Managing Welcome Messages
View a Welcome Message
See the raw embed script for a specific channel’s welcome message.
List All Welcome Messages
Show all configured welcome messages across the server with pagination.
Remove a Welcome Message
Stop sending welcome messages in a specific channel.
,welcome remove <channel>
Clear All Welcome Messages
Remove all welcome messages across the entire server.
This removes all welcome messages at once and cannot be undone.
Testing
Preview your welcome message without waiting for someone to join.
This simulates a member join event using your own account, sending the welcome message to the specified channel (or the current channel if not specified).
Always test your welcome messages after creating or editing them to make sure variables resolve correctly and the embed looks right.
Self-Destructing Messages
Add the --self_destruct flag to make the welcome message automatically delete itself after a set number of seconds.
,welcome add #welcome {embed}$v{title: Welcome {user}!}$v{description: Enjoy your stay!} --self_destruct 30
Example Welcome Messages
Simple Text Welcome
,welcome add #general {message: Welcome to the server, {user.mention}! Make sure to read the rules.}
Rich Embed Welcome
,welcome add #welcome {embed}$v{color: #F4D679}$v{title: Welcome to {guild}!}$v{description: Hey {user.mention}, you are our **{user.join_position_suffix}** member! We're glad to have you here.}$v{thumbnail: {user.display_avatar}}$v{footer: {guild} — Joined}$v{timestamp}
,welcome add #welcome {embed}$v{title: Welcome!}$v{description: {user.mention} just joined. Check out the rules!}$v{button: link && Read Rules && https://discord.com/channels/.../...}
Variables
Welcome messages support all pom variables. The most commonly used ones are:
| Variable | Output |
|---|
{user} | Member’s display name |
{user.mention} | Mentions the member |
{user.display_avatar} | Member’s avatar URL |
{user.join_position_suffix} | Join position with ordinal (e.g., “42nd”) |
{guild} | Server name |
{guild.count} | Total member count |
,welc