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
Enable the module
Dashboard → Your server → toggle Welcome
Configure messages
Click Edit to configure messages
Set up sections
Configure the Welcome (join) and Goodbye (leave) sections separately
Save
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)
DM Use Case
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 + assigns auto-roles + log |
on_member_remove | Sends goodbye message + log |
Auto Role
Automatically assign selected roles to every new member on join. Configure in Dashboard: Welcome → "Auto Role" section.
| Option | Type | Description |
|---|---|---|
auto_roles | string[] | List of role IDs to auto-assign |
Auto-role works independently of the welcome message — even if welcome message is disabled, roles will be assigned (as long as the Welcome cog is active).
No Commands
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
Best Practices
- 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
Permissions Required
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).