Welcome Messages

This feature allows you to set up custom welcome messages for new members joining your server. You can customize the message content, embed appearance, auto-roles, and even add ghost pings.

Quick Start (5 Minutes)

  1. Run ;welcome channel #welcome-channel

  2. Set your welcome message: ;welcome message Welcome {mention} to {server}!

  3. Set an auto-role: ;welcome role @Member

  4. Enable the system: ;welcome enable

  5. Test the message: ;welcome test

You're done! Read full setup below for advanced options.

Setup

  1. Set a welcome channel: ;welcome channel #your-channel

  2. Configure your welcome message: ;welcome message Welcome {mention} to {server}!

  3. Enable the welcome system: ;welcome enable

  4. Test your message: ;welcome test

Configuration

  • channel: The channel where welcome messages are sent.

  • message: The text content of the welcome message. Supports variables like {mention}, {server}, {membercount}.

  • title: The title of the welcome embed.

  • color: The color of the welcome embed (hex code or name).

  • reaction: An emoji to automatically react to the welcome message.

  • role: A role to automatically assign to new members.

  • authorName: The name displayed in the embed's author field.

  • authorIcon: The icon URL for the embed's author field.

  • footerText: The text displayed in the embed's footer.

  • footerIcon: The icon URL for the embed's footer field.

  • showTimestamp: Toggles the timestamp display in the embed.

  • showRole: Toggles the auto-role feature.

  • showAuthor: Toggles the author field display.

  • showFooter: Toggles the footer field display.

  • showThumbnail: Toggles the thumbnail display.

  • showReaction: Toggles the welcome reaction feature.

  • autoDelete: Automatically deletes the welcome message after a specified number of seconds (0 to disable).

  • image: An image URL to display in the embed.

  • showImage: Toggles the image display.

  • embedEnabled: Toggles whether the welcome message uses an embed or plain text.

  • ghostPingEnabled: Toggles the ghost ping feature.

  • ghostPingChannels: A list of channels where a ghost ping will be sent when a new member joins.

  • verifyRole: A role to assign when a user sends their first message in the verification channel.

  • verifyChannel: The channel where new users must send their first message to receive the verification role.

  • verifyEnabled: Toggles the message verification system.

  • useSavedEmbed: Uses a pre-saved embed template for welcome messages.

  • savedEmbedName: The name of the saved embed template to use.

Available Variables:

  • {mention} - Mentions the new member.

  • {user} - The new member's username.

  • {tag} - The new member's full tag (username#0000).

  • {server} - The name of the server.

  • {membercount} - The total number of members in the server.

  • {avatar} - The new member's avatar URL.

  • {servericon} - The server's icon URL.

  • {serverbanner} - The server's banner URL (if set).

Common Issues:

  • Auto-role is not assigned → Ensure the bot's highest role is positioned above the role being assigned.

  • Message is not sent → Check that the bot has Send Messages and View Channel permissions in the welcome channel.

  • Ghost pings are visible → The bot must have Manage Messages permission to delete the ping message immediately after sending it.

  • Variables are not replacing text → Ensure variables are enclosed in curly braces, e.g., {user}.

Usage

Once configured, new members joining your server will automatically receive the customized welcome message in the designated channel.

  • ;welcome - Main command for managing welcome messages.

  • ;embed - Create and manage custom embed templates.

Last updated

Was this helpful?