Docs Features Guide Welcome System

Welcome System

Automated welcome messages for new members with channel greetings, DM messages, auto-role assignment, and template variables

welcome greet join auto role dm new member message channel

Overview

The welcome system automatically greets new members when they join your server. Navigate to Left sidebar > Welcome on your server dashboard to configure all settings. Features include a customizable welcome message in a designated channel, an optional DM greeting sent privately to the new member, and automatic role assignment on join.

Enabling and Channel Setup

Toggle the enabled switch at the top of the Welcome settings page to activate the module.

channelId (channel picker): Select the channel where welcome messages are posted when new members join. The bot needs View Channel and Send Messages permissions in this channel. Choose a public channel like #welcome or #general so existing members can greet newcomers.

Welcome Message

message (text input, default 'Welcome {user} to {server}!'): The message posted in the welcome channel when a new member joins. You can use template variables to personalize the message:

{user} — Mentions the new member.
{server} — The server name.
{memberCount} — The current number of members in the server.

Combine these variables with custom text to create a warm, informative greeting. For example: 'Welcome {user} to {server}! You are member #{memberCount}.'

Auto Role

autoRoleId (role picker): Select a role to automatically assign to every new member when they join. This is commonly used to give new members a base role that grants access to general channels. Leave empty to skip automatic role assignment.

Make sure the bot's role is positioned above the auto-role in the server's role hierarchy, otherwise the bot cannot assign it.

DM Welcome

Send a private welcome message directly to new members:

dmEnabled (toggle, default off): Enable sending a DM to new members when they join.

dmMessage (text input): The message content sent as a direct message. Supports the same template variables as the channel welcome message ({user}, {server}, {memberCount}). Use this to share important information like server rules, useful channels, or getting-started instructions.

Note: Some members have DMs disabled. The bot will silently skip sending the DM if the member's privacy settings block it.

Tips

Keep your welcome message concise but informative — include the server name and a brief pointer to your rules channel. Use the DM message for detailed onboarding information that would clutter the public welcome channel. Set up the auto-role to give new members immediate access to your community channels. Test your welcome setup by having a friend join or by using the test feature to preview the message. If you use both the welcome channel message and DM, make sure the content complements rather than duplicates.