Docs / Welcome / Commands / /welcome set message
Admin Server only

/welcome set message

Set the welcome message

Usage

Generated
/welcome set message <text>
OptionTypeRequiredDescription
text text Yes Welcome message (use {user}, {server}, {member_count})

Who can run it

Generated
Discord defaultEvery member
Command Access presetServer managers
Always allowedThe server owner and, by default, Administrators
Change itDashboard, Services, Welcome, Commands

The presets keep it for server managers. Server owners and Administrators can always run it. How Command Access works.

What the bot needs

Generated

Welcome is granted these permissions by the invite link. A command that finds one missing replies privately with what it could not do and changes nothing.

View ChannelSend MessagesEmbed LinksAttach FilesManage Roles

Behaviour

Checked against the code 2026-10-01

Sets the single welcome message the bot posts when someone joins. Requires Manage Server; without it the bot replies "Requires Manage Server." The reply is visible only to you.

The text is saved as typed, cut at 2,000 characters. The bot replies "Welcome message updated." If the server uses a rotating list of welcome messages, the text is still saved but the bot tells you it will not be sent: "Saved, but this server sends a rotating list of welcome messages, so this one is not used. Edit the list on the Messages page:" with a link to the page.

Every tag in the Messages page's tag list is filled in when the message is sent: {user} (display name), {user.mention}, {user.name} (username), {user.id}, {server}, {member_count} and {created_at} (the date the account was created, such as Sep 21, 2026), plus more such as {member_count.ordinal} (1,234th), {join_count}, {user.account_age} and {inviter}. Conditions such as {if user.returning}Welcome back!{else}Welcome!{end} pick between two texts. The option hint only lists {user}, {server} and {member_count}. The default message is "Welcome to {server}, {user.mention}! You are member #{member_count}!".

Markdown works. User and role mentions ping. @everyone and @here are never sent as pings, whatever the message says.

Good to know

  • Nothing is posted until a welcome channel is set. Use /welcome set channel or the Messages page.
  • The command does not touch the embed, the colour, the card or the rotating list. The card is designed in the Card Studio and the rest lives on the Messages page.
  • The text is checked when you save it. If it looks like spam or a scam, the reply adds "The shared bot holds this text for review:" with the reasons, and the shared bot does not send it until you change it. A custom bot sends it anyway.
  • Run /welcome test to see the result before anyone joins.
YourBot docs Reference tables are generated from the code that is running. Ask in Discord Suggest a correction