Skip to main content

​
Overview

Welcome messages automatically send greetings to new members when they join your server. You can configure multiple welcome messages across different channels, use custom embeds, and even ping new members to make them feel welcomed.
Welcome messages support both plain text with variables and custom embeds created with the embed builder.

​
Commands

Add a welcome message or embed to a specific channel.
~welcome add <#channel> <message>
~welcome add <#channel> <embed_name>
~welcome add <#channel> <message> ping
~welcome add <#channel> <embed_name> ping
Parameters:
  • #channel — Channel where the welcome message will be sent
  • message — Your welcome message (supports variables)
  • embed_name — Name of a saved embed from your embed builder
  • ping — Optional flag to mention the new member
Available Variables:
  • {user.mention} — Mentions the new member
  • {user.tag} — User’s full tag (name#0000)
  • {user.id} — User’s ID
  • {guild.name} — Server name
  • {guild.count} — Total member count
  • {guild.id} — Server ID
Aliases: greet add, wlc add, welc add
Permissions: Manage Server
Add the word ping at the end of your command to mention new members when they join!
View all configured welcome messages for your server.
~welcome list
What It Shows:
  • Channel where each message is sent
  • Preview of text messages or embed names
  • Whether ping is enabled for each message
  • Numbered list for easy reference
Aliases: greet list, wlc list, welc list
Permissions: Manage Server
Remove all welcome messages from a specific channel.
~welcome remove <#channel>
What It Does:
  • Removes ALL welcome messages configured for the specified channel
  • Does not affect welcome messages in other channels
  • Shows how many messages were removed
Aliases: greet remove, wlc remove, welc remove
Permissions: Manage Server
Reset all welcome settings for your server.
~welcome reset
What It Does:
  • Removes ALL welcome messages from all channels
  • Clears all joinping configurations
  • Resets the entire welcome system
  • Cannot be undone
This action is permanent and removes all welcome configurations. Use with caution!
Aliases: greet reset, wlc reset, welc reset
Permissions: Manage Server
Test the welcome message in a specific channel.
~welcome test <#channel>
What It Does:
  • Sends a test welcome message using your profile
  • Applies all variables as if you just joined
  • Shows exactly how new members will see the message
  • Pings you if ping is enabled
Aliases: greet test, wlc test, welc test
Permissions: Manage Server
Only tests messages configured for the specified channel. Make sure you’ve added a welcome message there first.

​
Join Ping Commands

Join ping automatically pings new members in specified channels when they join, even without a welcome message.
Add a channel for automatic join pings.
~welcome joinping <#channel>
What It Does:
  • Pings new members in the specified channel
  • Works independently from welcome messages
  • Maximum of 50 channels per server
  • Shows current count (e.g., 5/50)
Aliases: greet joinping, wlc joinping, welc joinping
Permissions: Manage Server
Maximum limit: 50 joinping channels per server. Remove unused channels to add new ones.
View all channels configured for join pings.
~welcome joinping list
What It Shows:
  • All channels with joinping enabled
  • Total count out of 50 maximum
  • Numbered list for reference
Aliases: greet joinping list, wlc joinping list
Permissions: Manage Server
Remove join ping from a specific channel.
~welcome joinping remove <#channel>
What It Does:
  • Removes joinping from the specified channel
  • Does not affect welcome messages
  • Frees up a slot (now X/50 instead of X+1/50)
Aliases: greet joinping remove, wlc joinping remove
Permissions: Manage Server
Test joinping functionality across all configured channels.
~welcome joinping test
What It Does:
  • Pings you in all joinping channels
  • Verifies all channels are working correctly
  • Confirms bot has proper permissions
Aliases: greet joinping test, wlc joinping test
Permissions: Manage Server

​
Variable Reference

Use these variables in your welcome messages for dynamic content:
VariableOutputExample
{user.mention}Mentions the new member@Username
{user.tag}User’s full tagJohnDoe#1234
{user.id}User’s unique ID123456789012345678
{guild.name}Your server’s nameMy Awesome Server
{guild.count}Current member count1,234
{guild.id}Your server’s unique ID987654321098765432

​
How It Works

1

Configure Welcome Messages

Set up one or more welcome messages using welcome add:
~welcome add #welcome Welcome {user.mention}! You're member #{guild.count}
~welcome add #rules Please read the rules, {user.mention}
2

Optional: Add Join Pings

Enable automatic pings in specific channels:
~welcome joinping #general
3

Test Your Setup

Verify messages work correctly:
~welcome test #welcome
4

Automatic Greetings

When new members join:
  • All configured welcome messages are sent
  • Variables are replaced with actual values
  • Pings happen if enabled
  • Messages sent to their respective channels

​
Permission Requirements

Bot Permissions

The bot needs these permissions in welcome channels:
  • View Channel
  • Send Messages
  • Embed Links (for embed welcomes)
  • Mention @everyone (for pings)

User Permissions

Command Requirements:
  • Manage Server — Required for all welcome commands

​
Aliases

All welcome commands support multiple aliases:

greet

Short alias

wlc

Shorter alias

welc

Alternative

welcome

Full command

​
Troubleshooting

Problem: “You need the Manage Server permission to use this command”Solution:
  • Verify you have the Manage Server permission
  • Check your role has sufficient permissions
  • Ask a server administrator for access
Problem: Welcome messages don’t send when members joinSolutions:
  • Verify bot has Send Messages permission in welcome channel
  • Check bot has Embed Links permission (for embed welcomes)
  • Ensure channel hasn’t been deleted
  • Run ~welcome list to verify configuration
  • Test with ~welcome test #channel
Problem: “Embed Not Found” error when using embed welcomesSolutions:
  • Verify the embed exists: check with embed command
  • Ensure embed name is spelled correctly (case-sensitive)
  • Confirm embed is saved under your user account
  • Re-add the welcome message with correct embed name
Problem: Variables show as {user.mention} instead of actual valuesSolutions:
  • Check variable spelling exactly matches reference
  • Ensure you’re using curly braces {}
  • Variables only work in text messages, not embed names
  • For embeds, variables must be in the embed content itself
Problem: “You Have Reached The Maximum Limit Of 50 Join Ping Channels”Solution:
  1. View current channels: ~welcome joinping list
  2. Remove unused channels: ~welcome joinping remove #channel
  3. Add new channel: ~welcome joinping #new-channel
Problem: “That Channel Is Already Set As A Join Ping Channel”Solution:
  • The channel already has joinping enabled
  • Check with ~welcome joinping list
  • No need to add it again
Problem: New members aren’t getting pingedSolutions:
  • Ensure you added ping flag when setting up welcome message
  • Check bot has Mention @everyone permission
  • Verify with ~welcome list to see if (ping) appears
  • Re-add the welcome message with the ping flag

​
Usage Examples

# Simple text welcome
~welcome add #welcome Welcome to the server, {user.mention}!

# With member count
~welcome add #general Hey {user.mention}! You're member #{guild.count}

# Multiple messages
~welcome add #welcome Welcome {user.mention}!
~welcome add #rules Please read <#rules-channel>, {user.mention}

Embed Builder

Create custom embeds to use as welcome messages

Autorole

Automatically assign roles to new members when they join