Welcome & Goodbye
The Welcome module handles welcome and goodbye messages — sent automatically when someone joins or leaves the server. It supports both text messages and embeds with full customization.
Enabling the Module
- Dashboard → Your server → toggle Welcome
- Click Edit to configure messages
- Configure the Welcome (join) and Goodbye (leave) sections separately
- Save changes
Configuration
The Welcome module configuration consists of two independent sections:
welcome section (joining the server)
| Option | Type | Description |
|---|---|---|
enabled | boolean | Whether the welcome message is active |
channel_id | string | ID of the channel where the message is sent |
type | "message" / "embed" | Message type |
message | string | Text message content (when type = message) |
embed | object | Embed configuration (when type = embed) |
ping_everyone | boolean | Whether to ping @everyone |
send_dm | boolean | Whether to send a private message to the new member |
goodbye section (leaving the server)
| Option | Type | Description |
|---|---|---|
enabled | boolean | Whether the goodbye message is active |
channel_id | string | Target channel ID |
type | "message" / "embed" | Message type |
message | string | Text message content |
embed | object | Embed configuration |
ping_everyone | boolean | Whether to ping @everyone |
Placeholders
You can use variables in message content and embeds:
| Placeholder | Replaced by |
|---|---|
{user} | User mention (e.g., @John) |
{username} | User's display name |
{server} | Server name |
{membercount} | Current server member count |
Example:
Welcome {user} to {server}! You are our {membercount}th member!
Embed Configuration
When the message type is embed, the following fields are available:
| Field | Description |
|---|---|
title | Embed title |
description | Main content |
color | Hex color (e.g., #22C55E) |
thumbnail | Thumbnail URL |
image | Main image URL |
author_name | Author name |
author_icon | Author icon URL |
footer | Footer text |
fields | List of fields (name, value, inline) |
All text fields support placeholders.
Dashboard — Configuration
The Welcome edit panel in the dashboard contains:
Welcome Section
- Enabled toggle
- Channel selection (dropdown with text channels)
- Type selection: Message / Embed
- Embed editor (visual inline builder) — when Embed type is selected
- Ping @everyone checkbox
- Send as DM checkbox — when checked, an additional text field appears for the DM message
Goodbye Section
- Analogous configuration to Welcome
- No Send as DM option
UnsavedBar
The panel uses the UnsavedBar — changes are not saved automatically. Click Save to save or Cancel to revert.
Sending DMs
When the send_dm option is enabled:
- After joining the server, the bot sends the new member the same message (text or embed) as on the channel
- If the user has DMs disabled or has blocked the bot, the message is silently skipped (no error logging)
DMs are particularly useful for sending the server rules or instructions to new members.
Listened Events
| Event | Action |
|---|---|
on_member_join | Sends welcome message + optional DM + log |
on_member_remove | Sends goodbye message + log |
The module has no slash commands — it works exclusively on events.
Logging
Welcome module actions are logged by Logs under the welcome category:
- Member Joined — when someone joins the server
- Member Left — when someone leaves the server
Tips
- Use the Embed type for professional-looking messages with images and colors
- The
{membercount}placeholder is great for building a sense of community - Set a separate channel for welcome messages (e.g., #welcome) to avoid cluttering the main chat
- Enable DMs with the server rules so new members immediately know the guidelines
The bot must have the Send Messages and Embed Links permissions on the selected channel. If permissions are revoked after configuration, messages will not be sent (but it will be logged as a warning).