Setup Welcome

Configure the welcome system for new members. Set up automatic welcome messages, auto-roles, and customize the welcome experience.

Parameters

channel (required)

Channel where welcome messages will be sent

message (optional)

Welcome message (use placeholders like {user}, {server})

auto-role (optional)

Role to automatically assign to new members

enabled (optional)

Enable or disable the welcome system

embed (optional)

Use embed format for welcome messages

Placeholders

You can use these placeholders in your welcome message:

{user} - User mention
{username} - Username without mention
{server} - Server name
{memberCount} - Total member count
{userCount} - User count (excluding bots)

Step-by-Step Example

Choose a channel for welcome messages.
Run the command:

/setup-welcome 
channel:#welcome 
message:"Welcome {user} to {server}! 🎉"

The bot will configure the welcome system.

Set up with embed and auto-role:

/setup-welcome 
channel:#welcome 
message:"Welcome {user} to {server}! We now have {memberCount} members!" 
auto-role:@Member 
enabled:true 
embed:true

Configure auto-role assignment:

/setup-welcome 
channel:#general 
message:"Welcome {user}! You've been given the @Member role." 
auto-role:@Member 
enabled:true

Permissions Required

Manage Guild: Required to configure welcome system
Send Messages: Required to post welcome messages
Manage Roles: Required if using auto-role feature
Embed Links: Required if using embed format

Troubleshooting

Permission denied: You need Manage Guild permissions to configure welcome system.
Channel not found: Make sure the channel exists and the bot can access it.
Auto-role not working: Ensure the bot's role is above the auto-role in the role hierarchy.
Message not sending: Check bot permissions in the welcome channel.

/welcome-settings

View and manage welcome system settings

/role-reactions

Create role selection messages

Best Practices

Use a dedicated welcome channel for better organization.
Test the welcome system with a test account before going live.
Use placeholders to make messages more personal.
Consider using embeds for a more polished look.