Skip to content

Welcome System

Send welcome and leave messages, optional DMs, and auto-roles for new members.

Command Group

All welcome configuration is under /welcome.

Available Commands

Command Description
/welcome channel <channel> Set welcome channel and enable welcome messages
/welcome message <message> Set plain-text welcome message template
/welcome embed <title> <description> [color] [image_url] [thumbnail_url] Set embed-based welcome message
/welcome image <enabled> Enable or disable welcome card image
/welcome dm <message> Configure welcome DM (disable turns it off)
/welcome autorole [role] Toggle/view auto-roles for joins (up to 4)
/welcome leave [channel] [message] Configure leave messages (message:disable to turn off)
/welcome test Send a test welcome message
/welcome view Show current welcome configuration

Setup Flow

1) Set channel

/welcome channel channel:#welcome

2) Set message or embed

/welcome message message:"Welcome {user.mention} to {server.name}!"

Or embed mode:

/welcome embed title:"Welcome" description:"Read #rules and enjoy your stay." color:#2E7D32

3) Optional DM

/welcome dm message:"Welcome to {server.name}, {user.name}!"

Disable later with:

/welcome dm message:"disable"

4) Optional auto-role

/welcome autorole role:@Member

5) Validate

/welcome test
/welcome view

Template Variables

These placeholders are supported in welcome/leave text and embed text fields:

  • {user}
  • {user.mention}
  • {user.name}
  • {user.display_name}
  • {user.id}
  • {user.avatar}
  • {user.created_at}
  • {user.joined_at}
  • {server} and {server.name}
  • {server.members} and {member_count}
  • {server.id}
  • {server.icon}
  • {server.boost_level}
  • {server.boost_count}
  • {ordinal}

Leave Messages

Configure leave messages in one step:

/welcome leave channel:#goodbye message:"{user} left {server.name}."

Disable leave messages:

/welcome leave message:"disable"

Auto-Role Behavior

/welcome autorole supports up to 4 roles.

  • Running with a role toggles that role on/off in the auto-role list.
  • Running without a role shows the current configured auto-roles.
  • New members receive configured roles on join.

Troubleshooting

Welcome message not sending

  1. Run /welcome view and confirm welcome is enabled.
  2. Confirm the configured channel still exists.
  3. Confirm bot permissions in the channel: View Channel, Send Messages, Embed Links.

Auto-role not applied

  1. Confirm bot has Manage Roles.
  2. Confirm bot role is above target auto-roles.
  3. Confirm the role still exists and is not managed by another integration.

Template placeholders render as plain text

  1. Check spelling exactly (for example {user.mention}).
  2. Remove spaces inside braces.
  3. Re-save the message with /welcome message and test again.