Welcome

Configure welcome, leave, and boost messages with template variables and auto-role assignment.

The Welcome module sends customizable messages when members join, leave, or boost your server. You can also automatically assign roles to new members.

Quick Reference

Command	Description	Permission	Cooldown
`.welcome`	Configure welcome messages	Admin	3s
`.leave`	Configure leave messages	Admin	3s
`.boost`	Configure boost messages	Admin	3s
`.autorole`	Manage auto-assigned roles	Admin	3s

Welcome Messages

Send a message when a new member joins the server.

Setup

.welcome channel #welcome
.welcome message Welcome to the server, {user.mention}!

Subcommands

.welcome channel <#channel>     — Set the welcome channel
.welcome message <text>         — Set the welcome message
.welcome embed                  — Toggle embed mode (rich embed vs plain text)
.welcome dm                     — Toggle DM welcome messages
.welcome test                   — Send a test welcome message
.welcome settings               — View current settings
.welcome variables              — List available template variables

Aliases: greet Permission: Admin

Examples:

.welcome channel #welcome
.welcome message Welcome {user.mention} to **{server}**! You are member #{server.members}.
.welcome embed
.welcome dm
.welcome test

Leave Messages

Send a message when a member leaves the server.

Subcommands

.leave channel <#channel>      — Set the leave channel
.leave message <text>          — Set the leave message
.leave embed                   — Toggle embed mode
.leave test                    — Send a test leave message
.leave settings                — View current settings
.leave variables               — List available template variables

Aliases: goodbye, farewell Permission: Admin

Examples:

.leave channel #goodbye
.leave message {user} has left the server. We now have {server.members} members.
.leave test

Boost Messages

Send a message when a member boosts the server.

Subcommands

.boost channel <#channel>      — Set the boost message channel
.boost message <text>          — Set the boost message
.boost embed                   — Toggle embed mode
.boost test                    — Send a test boost message
.boost settings                — View current settings
.boost variables               — List available template variables

Aliases: boostmsg, boostmessage Permission: Admin

Examples:

.boost channel #boosts
.boost message Thank you {user.mention} for boosting! We now have {server.boosts} boosts!
.boost test

Auto Role

Automatically assign roles to new members when they join.

Subcommands

.autorole add <@role>          — Add a role to auto-assign
.autorole remove <@role>       — Remove a role from auto-assign
.autorole list                 — List all auto-assigned roles
.autorole delay <seconds>      — Set a delay before roles are assigned (0-600s)

Aliases: ar, joinrole Permission: Admin

Examples:

.autorole add @Member
.autorole add @Unverified
.autorole remove @Member
.autorole list
.autorole delay 10

You can assign up to 10 auto-roles. The delay setting is useful if you want to give the join gate time to process before assigning roles.

Template Variables

All welcome, leave, and boost messages support these template variables:

Variable	Description
`{user}`	The member's username
`{user.mention}`	The member as a mention (`@Alex`)
`{user.tag}`	The member's full tag (`Alex#1234`)
`{user.id}`	The member's user ID
`{user.avatar}`	URL to the member's avatar
`{server}`	The server's name
`{server.members}`	Total member count
`{server.boosts}`	Number of server boosts
`{server.icon}`	URL to the server icon
`{channel}`	The channel name where the message is sent

Use .welcome variables (or .leave variables / .boost variables) to see the full list.

Welcome

On this page